---
title: "Create a version snapshot"
method: POST
path: "/v1/templates/{template_id}/versions"
tags: ["Templates"]
---

# Create a version snapshot

`POST /v1/templates/{template_id}/versions`

Create an immutable snapshot of the current template draft.

## Path parameters

- `template_id` string, required — Template short ID (12 characters)

## Request body

- CreateVersionRequest — Request to create a version snapshot
  - `tag` string, required — Version tag (e.g. 'prod', 'staging', 'v1'). Lowercase alphanumeric with hyphens/underscores, 2-50 chars.
  - `description` string, nullable — Optional description for this version

## Response `200`

Successful Response

- VersionItem — Version item in list response
  - `version_number` integer, required — Version number
  - `tag` string, nullable — Version tag
  - `description` string, nullable — Version description
  - `created_at` string, required — ISO 8601 timestamp

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pdftemplateapi/apis/templatefox-api.md) · [All operations](https://skmtc.net/pdftemplateapi/apis/templatefox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pdftemplateapi/templatefox-api/revisions/5673fc0d5fad/schema)