v1

latestOpenAPI 3.1.02026-08-06244570.4 KB
Templates

Create a version snapshot

Create an immutable snapshot of the current template draft.

post/v1/templates/{template_id}/versions

Path parameters

template_idstring required

Template short ID (12 characters)

Template short ID (12 characters)

Request body

tagstring required

Version tag (e.g. 'prod', 'staging', 'v1'). Lowercase alphanumeric with hyphens/underscores, 2-50 chars.

descriptionstring nullable

Optional description for this version

Example request

{
  "tag": "prod"
}

Response

Successful Response

version_numberinteger required

Version number

tagstring nullable

Version tag

descriptionstring nullable

Version description

created_atstring required

ISO 8601 timestamp

Example response

{
  "version_number": 1,
  "tag": "prod"
}