Resources
Remove assets from a collection
Take one or more images out of an image collection.
DELETE /api/assets/collections/{collectionId}/itemsRequires assets:update.
| Field | Required | Description |
|---|---|---|
workspace | Yes | Workspace slug or id. |
assetIds | Yes | At least one image id. |
curl --request DELETE "https://app.kalpana.one/api/assets/collections/COLLECTION_ID/items" \
--header "x-api-key: $KALPANA_API_KEY" \
--header "content-type: application/json" \
--data '{"workspace":"acme","assetIds":["ASSET_ID"]}'Response
{ "success": true, "count": 1 }The images stay in the workspace and in any other collections. count is the number of distinct ids you sent, whether or not they were in the collection. A collection or image that is not in the workspace is not an error; nothing is removed for it.
Errors
| Status | Cause |
|---|---|
400 | assetIds is empty. |
403 | Your role or key lacks assets:update. |
Was this page helpful?
Updated 4 Nov 2026