Resources
Add assets to a collection
Put one or more images in an image collection.
POST /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 POST "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_1","ASSET_ID_2"]}'Response
{ "success": true, "count": 2 }count is the number of distinct ids you sent, including images already in the collection. Images stay in any other collections they belong to. To replace the collections of one image, use Set an asset's collections.
Errors
| Status | Cause |
|---|---|
400 | assetIds is empty. |
403 | Your role or key lacks assets:update. |
404 | The collection, or an image in assetIds, is not in this workspace. Nothing is added. |
Was this page helpful?
Updated 4 Nov 2026