Resources
List template collections
List the collections that group templates, with item counts and previews.
GET /api/template-collectionsRequires templates:read.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
workspace | string | Yes | Workspace slug or id. |
search | string | No | Case-insensitive match on the collection name. |
curl "https://app.kalpana.one/api/template-collections?workspace=acme" \
--header "x-api-key: $KALPANA_API_KEY"Response
An array, most recently updated first. It is not paginated.
[
{
"id": "0192f8a4-6c1e-7c3a-9b0e-4d2f1a7e5c11",
"workspaceId": "ws_123",
"name": "Festive sale",
"description": null,
"createdBy": "user_123",
"createdAt": "2026-09-01T10:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z",
"itemCount": 3,
"previewUrls": ["https://cdn.example/preview.png"]
}
]itemCount counts the templates in the collection that are not deleted. previewUrls holds up to four first-page previews of the most recently added templates that have one. To list the templates of one collection, pass its id as collectionId to List templates.
Errors
| Status | Cause |
|---|---|
403 | Your role or key lacks templates:read. |
Was this page helpful?
Updated 4 Nov 2026