Resources
Move creatives to a folder
Put one or more finished files in a creative folder.
POST /api/creative-collections/{collectionId}/creativesRequires creatives:update.
| Field | Required | Description |
|---|---|---|
workspace | Yes | Workspace slug or id. |
creativeIds | One of these | Creative ids to put in the folder. |
creativeId | One of these | A single creative id. Ignored when creativeIds is sent. |
curl --request POST "https://app.kalpana.one/api/creative-collections/FOLDER_ID/creatives" \
--header "x-api-key: $KALPANA_API_KEY" \
--header "content-type: application/json" \
--data '{"workspace":"acme","creativeIds":["cre_123","cre_456"]}'Response
{ "success": true, "count": 2 }A file is in at most one folder, so this moves it: a file already in another folder leaves that folder. count is the number of distinct ids you sent.
Errors
| Status | Cause |
|---|---|
400 | Neither field holds an id. The message is No creative IDs provided. |
403 | Your role or key lacks creatives:update. |
404 | The folder, or a creative you sent, is not in this workspace. Nothing is moved. |
Was this page helpful?
Updated 4 Nov 2026