Resources
List image collections
List the collections images are grouped in, with counts and previews.
GET /api/assets/collectionsRequires assets:read.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
workspace | string | Yes | Workspace slug or id. |
search | string | No | Case-insensitive match on part of the collection name. |
curl "https://app.kalpana.one/api/assets/collections?workspace=acme" \
--header "x-api-key: $KALPANA_API_KEY"Response
{
"totalAssetsCount": 120,
"uncategorizedCount": 34,
"collections": [
{
"id": "0192f8a4-6c1e-7c3a-9b0e-4d2f1a7e5c11",
"workspaceId": "ws_123",
"name": "Products",
"description": null,
"createdBy": "user_123",
"createdAt": "2026-09-01T10:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z",
"itemCount": 86,
"previewUrls": ["https://cdn.example/temporary-url"]
}
]
}Every collection is returned in one response, newest first; there is no paging. totalAssetsCount counts the workspace's images and uncategorizedCount those in no collection. previewUrls holds up to four of the most recently updated images in each collection, as temporary links.
An image can be in more than one collection. Pass a collection's id as collectionId to List assets to list its images.
Was this page helpful?
Updated 4 Nov 2026