---
title: "Create template version"
method: POST
path: "/documents/templates/{templateID}/versions/"
tags: ["Guided Templates"]
---

# Create template version

`POST /documents/templates/{templateID}/versions/`

Creates a new template version. Returns raw authored values without inheritance resolution or section expansion.

## Request body

- GuidedTemplatesCreateVersionRequest
  - `generation` GuidedTemplatesVersionGeneration, required — When the template inherits from another template, all inner fields are optional. Any field omitted is inherited from the parent's published version.
    - `instructions` GuidedTemplateInstructionsPartial — Partial form of GuidedTemplateInstructions used when inheriting from another template. Any field omitted is inherited.
      - `prompt` string — Override the inherited template-level prompt instructions.
    - `sections` GuidedTemplatesVersionSectionRequest[]
      - `sectionId` string, uuid, required — The UUID of the section to include in the template version.
      - `orderIndex` integer — Sets the order of this section within this template. Starts at 0.

## Response `201`

Created — returns shallow (unresolved) template version

- GuidedShallowTemplateVersionResponse — Template version with raw authored values — no inheritance resolution applied. Sections are returned as references (IDs), not fully resolved objects. Use this to inspect what was explicitly set on this version versus inherited. Returned by GET, LIST, and POST version endpoints.
  - `id` string, uuid, required — The UUID of the version.
  - `versionNumber` integer, required — Starts at 0 and auto-increments.
  - `deletedAt` string, date-time, nullable — Present when the template version has been deleted.
  - `generation` GuidedShallowTemplateGeneration, required — Template generation with section references (not fully resolved). Use the resolved GuidedTemplateGeneration for hydrated section data.
    - `instructions` GuidedTemplateInstructions, required
      - `prompt` string, required — Template-level prompt instructions that apply generally to all sections.
    - `sections` GuidedTemplateVersionSectionRef[], required — Section references linked to this version (not fully resolved).
      - `sectionId` string, uuid, required — The UUID of the section linked to this template version.
      - `orderIndex` integer, required — The ordering position of the section within the template version.

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/corti/apis/admin-api.md) · [All operations](https://skmtc.net/corti/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corti/admin-api/revisions/5d1895a1b3fc/schema)