Resources
List creative folders
List the folders finished files are saved in, with previews.
GET /api/creative-collectionsRequires creatives:read. A folder is called a creative collection in the API.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
workspace | string | Yes | Workspace slug or id. |
search | string | No | Case-insensitive match on the folder name. |
page | number | No | Page number. Defaults to 1. |
limit | number | No | Items per page. Defaults to 32, from 1 to 100. |
curl "https://app.kalpana.one/api/creative-collections?workspace=acme" \
--header "x-api-key: $KALPANA_API_KEY"Response
{
"collections": [
{
"id": "0192f8a4-6c1e-7c3a-9b0e-4d2f1a7e5c11",
"workspaceId": "ws_123",
"name": "September products",
"description": null,
"createdBy": "user_123",
"createdAt": "2026-09-01T10:00:00.000Z",
"updatedAt": "2026-09-01T10:05:00.000Z",
"previewUrls": ["https://cdn.example/temporary-url"]
}
],
"total": 1,
"page": 1,
"limit": 32
}Folders are ordered by last update, newest first. previewUrls holds up to four of the newest files in each folder.
Pass a folder's id as collectionId to List creatives to list its files, or as collection when you create a batch to save the batch's files there. A batch without one gets its own folder when it first runs.
Was this page helpful?
Updated 9 Nov 2026