Describe a template's fillable inputs
get_template_inputsReturns the inputs of one template page that batch rows can fill; pageId picks a page other than the first, since each page has its own inputs. For each input: its id, label, text or image type, whether it is required, its default (a text input's value, an image input's asset and preview), image slot size and fit, the key rows use for it (its name, or its id when two layers share the name), a text input's styles (s1, s2, ...) when it has several, and a valueExample. rowExample is a whole ready row. These keys and values are what validate_batch, create_batch, update_batch and update_job accept. Inputs the author turned off or put on hidden layers are left out unless includeDisabled or includeHidden asks for them; omittedInputs names them. Their template text still renders, so check them (dates, terms, links) when the copy changes theme; a row can still fill them by key. An animated template also gives its duration and its stillTime. The layout is not returned: to see the template use inspect_image on its previewUrl, and to find templates search_templates. Needs templates:read.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"templateId": "<templateId>"
},
"name": "get_template_inputs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flowId | No | One video of the template (from flows) instead of a page: its inputs, one per layer name across its pages | |
| pageId | No | One page of the template (the designer connection's page_id), for its inputs. A template's pages are separate designs, each with its own inputs; the first page when omitted. | |
| templateId | Yes | The whole template, from search_templates. Not a page or flow id. | |
| includeHidden | No | Also return inputs on layers hidden in the template | |
| includeDisabled | No | Also return inputs the template author turned off |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| name | Yes | ||
| flows | No | The template's videos, each joining its own pages with transitions. Pass an id as flowId here for its inputs, and as flow to the batch tools or a job to render it | |
| pages | No | The template's pages; each is a separate design with its own inputs | |
| width | Yes | Width in pixels; null if unknown | |
| flowId | No | The video these inputs are from, when flowId was given | |
| height | Yes | Height in pixels; null if unknown | |
| inputs | Yes | ||
| pageId | No | The page these inputs are from (pass it in pages to the batch tools, or as a job's page) | |
| openUrl | Yes | Link that opens the template in the Kalpana app | |
| duration | No | An animated template's timeline length in seconds | |
| stillTime | No | The second the page's still image shows, set by its designer. Images use it unless create_batch gives stillTime; without either, they show the last frame | |
| isAnimated | No | True when the template moves; each image shows one moment of the motion | |
| rowExample | No | Modifications filling every input: copy and edit them as a row's or a job's modifications | |
| description | Yes | ||
| omittedInputs | No | Inputs left out of `inputs`. Their template text renders as designed unless a row fills them by key; check them when the copy changes theme (dates, terms, links) |