List a collection's assets
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.
Basic authentication using Cloudinary API Key and API Secret.
In: header
Path Parameters
The cloud name of your Cloudinary product environment.
External ID of the collection whose assets to list, add, or remove.
Query Parameters
Sort expression: <field> <direction>, optionally comma-separated for a multi-key sort (e.g. bytes desc, created_at asc). field is one of created_at, uploaded_at, public_id, display_name, or bytes, and direction is asc or desc. Defaults to created_at desc. When paging with next_cursor, send the same sort_by on every page; a cursor is only valid for the sort it was issued with.
Maximum number of assets to return (1-100, default 20).
1 <= value <= 100Opaque cursor from a previous response's next_cursor to fetch the next page. Send it with the same sort_by (and max_results) as the request that returned it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/asset_management/demo/collections/col_8f3a2b1c9d4e/assets?sort_by=bytes+desc&max_results=20"{ "data": [ { "asset_id": "3515c6000a548515f1134043f9785c2f", "public_id": "summer/beach-hero", "display_name": "beach-hero", "resource_type": "image", "type": "upload", "format": "jpg", "bytes": 482113, "width": 1920, "height": 1080, "secure_url": "https://res.cloudinary.com/demo/image/upload/v1720000000/summer/beach-hero.jpg", "created_at": "2026-03-14T10:15:00Z" } ], "next_cursor": "8edbc61040178db60b0973ca9494bf3a", "total_count": 12}Update a collection PUT
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.
Add assets to a collection POST
Adds assets to an existing collection. The caller must be allowed to update the collection and view the assets.