Update a public page

New display name for the public page. Omit to leave the current value unchanged.

New activation time for the page. Omit to leave the current value unchanged.

New expiry time for the page. Omit to leave the current value unchanged.

Whether viewers may download the original asset. Omit to leave the current value unchanged.

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). The list replaces the page's current download transformations; pass an empty list to remove them all. Omit to leave the current value unchanged. At most 200 entries.

When 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.

Secured-sharing protection mode. none removes protection and clears the allowed emails, domains and allow_any. email_otp protects the page so viewers must verify an allowed email address with a one-time passcode; a protected page needs at least one allowed email or domain, or allow_any: true. Omit to leave the current mode unchanged: on a protected page the allowlist fields below then update its allowlist, but on an unprotected page they are ignored, so send email_otp to protect it.

Email addresses allowed to access the page when it is protected. The list replaces the current one; send an empty array to clear it (the page must still satisfy the allow_any rule). Together with allowed_domains, at most 500 entries. Omit to leave the current value unchanged.

Email domains allowed to access the page when it is protected, as bare lowercase domains such as example.com. The list replaces the current one; send an empty array to clear it (the page must still satisfy the allow_any rule). Together with allowed_emails, at most 500 entries. Omit to leave the current value unchanged.

Whether any email address is allowed to access the page when it is protected. After the update, an email_otp page needs allow_any: true or at least one entry in allowed_emails or allowed_domains; otherwise the request fails with 400 invalid_protection_settings. Omit to leave the current value unchanged.

URL of a custom HTML page in your product environment to use in place of the public page's default design. It must be an https URL on a cloudinary.com host that belongs to this product environment, at most 2048 bytes. Setting it requires the custom collection layout feature on your plan; otherwise the request fails with 403. Pass an empty string to return to the default design. Omit to leave the current value unchanged.