Kalpana Docs
Resources

Get a template summary

Read each page's variable layers, video preview and last change, without the design.

GET /api/templates/{id}/summary

Requires templates:read.

Query parameters

NameTypeRequiredDescription
workspacestringYesWorkspace slug or id.
curl "https://app.kalpana.one/api/templates/tpl_123/summary?workspace=acme" \
  --header "x-api-key: $KALPANA_API_KEY"

Response

{
  "id": "tpl_123",
  "missingFonts": [
    { "family": "Inter", "style": "Bold", "weight": 700, "italic": false }
  ],
  "pages": [
    {
      "id": "page_123",
      "updatedAt": "2026-09-01T10:00:00.000Z",
      "previewVideoUrl": null,
      "nodes": {
        "headline": { "id": "headline", "name": "Headline", "node_type": "RichText", "visible": true },
        "hero_image": { "id": "hero_image", "name": "Hero image", "node_type": "Rectangle", "visible": true, "fills": [] }
      },
      "variables": {
        "headline": { "enabled": true },
        "hero_image": { "enabled": true, "description": "Product photo" }
      }
    }
  ]
}
FieldDescription
idThe template id.
missingFontsFonts used on any page that the workspace has not uploaded, each listed once.
pagesEvery page, in the same order as pages in List templates.
pages[].idThe page id. null for a template not yet split into pages.
pages[].updatedAtWhen the page last changed. null for a template not yet split into pages.
pages[].previewVideoUrlThe page's video preview, or null.
pages[].nodesThe page's variable layers, keyed by variable id, with each layer's id, name, node_type and visible. A layer with fills also has an empty fills array: such a layer takes an image.
pages[].variablesEach variable's saved settings, keyed by variable id: enabled, visible and description when set. Default values are not included.

This is lighter than Get a template: it leaves out the design, the variables' default values and the signed asset URLs. Unlike Get a template, missingFonts covers every page, not only the first.

Errors

StatusCause
403Your role or key lacks templates:read.
404The template is not in this workspace or has been deleted.
Was this page helpful?

Updated 4 Nov 2026

On this page