Cloudinary API
Cloudinary DocsGet API keys
HomeAPI ReferenceSDKsContext Plugin
Collections

Add assets to a collection

POST
/v2/asset_management/{cloud_name}/collections/{collection_id}/assets

Adds assets to an existing collection. The caller must be allowed to update the collection and view the assets.

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 whose assets to list, add, or remove.

Request Body

application/json

A list of asset_id values of the assets to add to the collection.

[index: integer]?string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v2/asset_management/demo/collections/col_8f3a2b1c9d4e/assets" \  -H "Content-Type: application/json" \  -d '[    "ast_1a2b3c4d5e6f"  ]'
{  "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": "manual"  }}

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.

Remove assets from a collection DELETE

Removes the specified assets from an existing collection. The caller must be allowed to update the collection. Assets that are not in the collection are ignored, and the underlying assets are not modified or deleted.