---
title: "Get template"
method: GET
path: "/api/templates/{id}"
tags: ["Templates"]
---

# Get template

`GET /api/templates/{id}`

## Request

- Base URL: `https://api.zvid.io`
- URL: `https://api.zvid.io/api/templates/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Fetch a stored template, including its `variables` defaults. Templates are
authored in the editor (Save → Save as template) or via the dashboard.

## Path parameters

- `id` string, required

## Response `200`

Stored template, including template.project

- TemplateEnvelope
  - `template` Template, required
    - `id` string, required
    - `userId` integer
    - `name` string, required
    - `description` string, nullable
    - `project` RenderPayload, required (unresolved $ref)
    - `type` 'video' | 'image'
    - `variablesSummary` TemplateVariableSummary[]
      - `name` string, required
      - `type` string
      - `used` boolean
      - `default` unknown
    - `version` integer
    - `status` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `401`: Unauthorized
- `404`: Template not found

---

[API](https://skmtc.dev/zvid/apis/zvid-api.md) · [All operations](https://skmtc.dev/zvid/apis/zvid-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zvid/apis/zvid-api/revisions/8a665b293b37?raw)