Publish a collection
Creates a shareable public page for the collection and returns its URL.
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 to create or list public pages for.
Request Body
application/json
Settings for the public page. Every field is optional; omitted fields use their documented default.
Optional display name for the public page.
When the page becomes active. If omitted or null, the page is active immediately.
date-timeWhen the page expires. If omitted or null, the page never expires.
date-timeWhether viewers can download the original asset. Omit to use the account default set by an administrator in the Media Library Preferences.
Named transformations that viewers of the public page can apply when downloading assets, referenced by name (see the Admin API's Get transformations endpoint to list the named transformations in your product environment). By default, each name must already be set as a transformation template; set create_download_transformations to true to set any listed name that isn't one yet automatically. Omit or pass null to leave the page without download transformations. At most 200 entries.
items <= 200When true, any name in download_transformations that isn't yet set as a transformation template is set as one automatically. It then appears in the Console's templates list and counts toward your product environment's template limit. When false or omitted, the request instead fails with download_transformation_not_available if any listed name isn't yet set as a transformation template, and nothing is changed.
falseResponse 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/public_pages" \ -H "Content-Type: application/json" \ -d '{}'{ "data": { "id": "pub_2c4d6e8f0a1b", "url": "https://collection.cloudinary.com/your-cloud-name/pub_2c4d6e8f0a1b", "name": "Summer Campaign Preview", "available_from": "2026-03-20T00:00:00Z", "expires_at": "2026-04-20T00:00:00Z", "show_download_original_option": true, "download_transformations": [ { "name": "thumbnail_400", "transformation": "c_thumb,w_400,g_face", "types": [ "image" ] } ], "protection_mode": "email_otp", "allowed_emails": [ "alice@example.com", "bob@example.com" ], "allowed_domains": [ "example.com" ], "allow_any": false, "custom_layout_url": "https://res.cloudinary.com/demo/raw/upload/layouts/summer-page.html" }}