Resources
Create a template collection
Create a collection, optionally with templates already in it.
POST /api/template-collectionsRequires templates:create. Returns 201 with the new collection.
| Field | Required | Description |
|---|---|---|
workspace | Yes | Workspace slug or id. |
name | Yes | Collection name. Cannot be empty. |
description | No | Free-form note. |
templateIds | No | Templates to put in the collection. Repeated ids count once. |
curl --request POST "https://app.kalpana.one/api/template-collections" \
--header "x-api-key: $KALPANA_API_KEY" \
--header "content-type: application/json" \
--data '{"workspace":"acme","name":"Festive sale","templateIds":["tpl_123"]}'Response
{
"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"
}Collection names are unique in a workspace, ignoring case. The new collection is not returned with itemCount or previewUrls; List template collections adds them.
Errors
| Status | Cause |
|---|---|
400 | A template in templateIds does not exist in the workspace or has been deleted. The message is One or more selected templates do not exist. |
403 | Your role or key lacks templates:create. |
500 | A collection with the same name, ignoring case, already exists. The message is Failed to create template collection. |
Was this page helpful?
Updated 4 Nov 2026