Skip to main content
Create new template version

Authorizations

Authorization
string
header
required

LithoBlocks API key obtained from your organization dashboard. The LithoBlocks MCP server also presents a Supabase-issued user session token here on the user's behalf; such a token acts as that user with the scopes their organization role allows.

Headers

Idempotency-Key
string

Any unique string (a UUID is fine). Repeating a request with the same key and body within 24 hours replays the original response with Idempotency-Replayed: true instead of running again; the same key with a different body is a 409. Incomplete and 5xx outcomes are retained for reconciliation beyond 24 hours. Applies only on the documented endpoints. Never automatically change keys to bypass an uncertain outcome.

Required string length: 1 - 255
Example:

"3f7d2c1a-9b4e-4f0a-8c6d-2e1b5a7c9d10"

Path Parameters

id
string<uuid>
required

Body

application/json

Version creation data

blocks
object[]

The template's blocks. Preferred over message.

Minimum array length: 1
message
object

Deprecated: { blocks }; use blocks directly

status
string
deprecated

Deprecated: a free-text label that nothing enforces; stored as sent, draft when omitted. Whether a version is live is is_current; activate it to make it live. Sending it adds a Deprecation response header.

note
string

Why this version exists; shown in the version history

Maximum string length: 500
sample_data
object

Data the blocks are validated against; defaults to a null-filled skeleton of the request format

entity_id
string
request_format
object

Override; derived from the blocks when omitted

Response

Created version

id
string
required
template_id
string
required
version_number
number
required
status
string
required
deprecated

Deprecated: the stored free-text label, which says nothing about whether the version is live. Use is_current.

is_current
boolean
required

Whether this is the template's live version: the one sends and compiles use

created_at
string
required
created_by
string | null
required
entity_id
string | null
required
source
enum<string> | null
required

Where the version was created; null for versions from before 2026-09-24

Available options:
web,
api,
mcp,
system,
migration,
legacy
note
string | null
required

Why the version was created, when the author said

message
unknown
sample_data
unknown
request_format
unknown