Skip to main content
POST
Save Version

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) or, for the admin-keys endpoints, a dashboard session token — sent as Authorization: Bearer <token>.

Headers

X-Mesh-Version
enum<string>
default:2026-08

Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.

Available options:
2026-08,
2026-09

Path Parameters

template_id
string
required

Body

application/json

A new immutable snapshot of a template's behavioral content. A field left unset carries over from latest_version_id — changing just system doesn't require resending messages.

system
string | null
messages
Messages · object[] | null
model
string | null
params
Params · object | null
variables
string[] | null

Response

Successful Response

id
string
required
template_id
string
required
version_number
integer
required
system
string | null
required
messages
Messages · object[] | null
required
model
string | null
required
params
Params · object | null
required
variables
string[] | null
required
reverted_from_version_id
string | null
required
created_by
string | null
required
created_at
string
required
is_published
boolean
required
published_at
string | null
required