Resources
Download a creative folder
Get a download link for every file in a folder.
GET /api/creative-collections/{collectionId}/downloadRequires creatives:read. This returns JSON with a link per file, not a ZIP. Fetch each url to save the files.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
workspace | string | Yes | Workspace slug or id. |
curl "https://app.kalpana.one/api/creative-collections/FOLDER_ID/download?workspace=acme" \
--header "x-api-key: $KALPANA_API_KEY"Response
{
"collection": {
"id": "0192f8a4-6c1e-7c3a-9b0e-4d2f1a7e5c11",
"name": "Festive sale"
},
"files": [
{
"id": "cre_123",
"displayName": "festive-sale-1.png",
"storageKey": "…",
"s3Key": "…",
"url": "https://cdn.example/…"
}
]
}Every file in the folder is returned in one response, oldest first; there is no paging. s3Key repeats storageKey. url is a CDN address for download. Use displayName as the file name when you save it.
Errors
| Status | Cause |
|---|---|
403 | Your role or key lacks creatives:read. |
404 | The folder is not in this workspace. The message is Collection not found. |
Was this page helpful?
Updated 4 Nov 2026