Resources
Rename an image collection
Change a collection's name or description.
PATCH /api/assets/collections/{id}Requires assets:update.
| Field | Required | Description |
|---|---|---|
workspace | Yes | Workspace slug or id. |
name | Yes | New name. Cannot be empty. Spaces at either end are trimmed. |
description | No | New description. Send "" to clear it. Leave it out to keep the current one. |
curl --request PATCH "https://app.kalpana.one/api/assets/collections/COLLECTION_ID" \
--header "x-api-key: $KALPANA_API_KEY" \
--header "content-type: application/json" \
--data '{"workspace":"acme","name":"Products 2026"}'Response
Returns the updated collection, in the shape shown in Create an image collection.
Names are unique in a workspace, ignoring case. A name another collection already has is refused with 500 and Failed to update asset collection.
Errors
| Status | Cause |
|---|---|
400 | name is missing or empty. |
403 | Your role or key lacks assets:update. |
404 | The collection is not in this workspace. |
500 | The name is already taken, or empty once trimmed. |
Was this page helpful?
Updated 4 Nov 2026