Collections
Create a collection
Creates a collection under the given product environment and makes the caller the owner.
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.
Request Body
application/json
name*string
Name of the collection.
description?string
Optional description of the collection.
type?string
Type of the collection. manual holds an explicit asset list and starts empty until you add assets with the Add assets to a collection endpoint; dynamic is defined by a saved filter expression and is populated automatically.
Default
"manual"Value in
- "manual"
- "dynamic"
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
curl -X POST "https://example.com/v2/asset_management/demo/collections" \ -H "Content-Type: application/json" \ -d '{ "name": "Summer campaign images", "type": "dynamic", "configuration": { "expression": "tags = \\"summer-campaign\\" AND resource_type:image" } }'{ "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" }}