Resources
List creatives
Search and paginate finished files in a workspace or creative folder.
GET /api/creativesRequires creatives:read.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
workspace | string | Yes | Workspace slug or id. |
collectionId | string | No | Only files in this creative folder. See List creative folders. |
search | string | No | Case-insensitive match on the display name. |
sortBy | string | No | recent (default, newest first), name (A to Z, ignoring case), or size (largest first). |
page | number | No | Page number. Defaults to 1. |
limit | number | No | Items per page. Defaults to 20, from 1 to 100. |
curl "https://app.kalpana.one/api/creatives?workspace=acme&sortBy=recent&limit=50" \
--header "x-api-key: $KALPANA_API_KEY"Response
{
"files": [
{
"id": "cre_123",
"workspaceId": "ws_123",
"jobId": "job_123",
"displayName": "september-products-1.png",
"contentType": "image/png",
"sizeBytes": 184233,
"width": 1080,
"height": 1080,
"createdAt": "2026-09-01T10:05:00.000Z",
"storageKey": "…",
"url": "https://cdn.example/…"
}
],
"total": 1,
"currentCollection": null
}jobId links a file back to the row that produced it. currentCollection is the folder when collectionId was set, in the shape shown in Create a creative folder, otherwise null. It is also null when the folder is not in the workspace, and files is then empty. url is a CDN address for preview or download.
Was this page helpful?
Updated 4 Nov 2026