Cloudinary API
Cloudinary DocsGet API keys
HomeAPI ReferenceSDKsContext Plugin
Collections

Update a collection

PUT
/v2/asset_management/{cloud_name}/collections/{collection_id}

Updates a collection's name, description, and (for dynamic collections) configuration. Only the fields you include in the request are changed. The caller must be allowed to update the collection. A collection's type (manual/dynamic) is fixed at creation and can't be changed.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your Cloudinary product environment.

collection_id*string

External ID of the collection to retrieve, update, or delete.

Request Body

application/json

The collection attributes to update. Only the fields you include are changed. A collection's type is set when the collection is created and can't be changed.

name?string

New name for the collection. Omit to leave the current name unchanged.

description?|

New description for the collection. Send null or an empty string to clear it. Omit to leave the current description unchanged.

configuration?

Configuration for a dynamic collection. Required when creating a dynamic collection, and not allowed for a manual collection.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v2/asset_management/demo/collections/col_8f3a2b1c9d4e" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "id": "col_8f3a2b1c9d4e",    "name": "Summer Campaign Assets",    "creator_type": "user",    "creator_id": "usr_4a1b2c3d5e6f",    "created_at": "2026-03-14T10:15:00Z",    "updated_at": "2026-03-15T09:30:00Z",    "description": "Approved photography for the summer campaign launch.",    "type": "dynamic",    "configuration": {      "expression": "tags = \"summer-campaign\" AND resource_type:image"    },    "asset_count": 12,    "cover_asset_url": "https://res.cloudinary.com/demo/image/upload/sample.jpg"  }}

Delete a collection DELETE

Deletes a collection. The caller must be allowed to update the collection; the underlying assets are not modified or deleted.

List a collection's assets GET

Returns the assets in a collection, newest first by default. For a `manual` collection, these are the assets that have been added to it; for a `dynamic` collection, they're the assets currently matching its filter expression. Only assets the caller has permission to view are included. Results are paginated: pass the returned `next_cursor` back to fetch the next page.