cloudinary

1# Cloudinary
2 
3## Purpose
4Manage media on Cloudinary through the Upload and Admin APIs: upload images and videos, list and inspect assets, update metadata and tags, delete assets, and check plan usage (credits, storage, bandwidth, transformations).
5 
6## Tooling
7All commands go through `bin/cloudinary.py`:
8 
9```bash
10bin/cloudinary.py auth                                        # verify the connection (also shows plan usage)
11bin/cloudinary.py usage                                       # plan usage: credits, storage, bandwidth, transformations
12bin/cloudinary.py upload --file ./photo.jpg                  # upload an image
13bin/cloudinary.py upload --file ./clip.mp4 --resource-type video   # upload a video
14bin/cloudinary.py upload --file ./photo.jpg --folder products # upload into a folder
15bin/cloudinary.py list --prefix products/ --max-results 20    # list image assets
16bin/cloudinary.py get --public-id products/photo1            # asset details
17bin/cloudinary.py update --public-id products/photo1 --data '{"tags":["summer"],"context":{"caption":"Beach"}}'
18                                                             # update metadata/tags (raw JSON body, per Cloudinary docs)
19bin/cloudinary.py delete --public-id products/photo1         # delete an asset
20```
21 
22## Auth
23- Provider id: `cloudinary` (credential is collected as `custom.cloudinary`)
24…