Skip to main content
POST
Save a new preset version

Authorizations

x-api-key
string
header
required

Path Parameters

name
string
required

Body

application/json

A new-preset-version request. At least one field must be present; an omitted field carries forward, an explicit [] clears (the store sentinel rule). output_schema carries forward when omitted, clears on an explicit null, and wins on an explicit object schema; input_schema follows the SAME carry-forward rule (omitted carries, null clears, an object schema wins). description carries forward when omitted and is SET by an explicit non-empty string (an explicit "" is rejected — the resulting description is validated non-empty on every save).

description
string | null
extensions
((string | object)[])[] | null
fixed_kwargs
Fixed Kwargs · object | null
input_schema
TemplatedText · object

A renderable text: its source plus the parameters its render takes.

EXACTLY ONE source is set — content (the text inline) or id (the id of a stored resource holding the text); neither and both are refused at construction. kwargs are the render parameters for the TEXT and apply either way, so moving a text from inline to stored (or back) leaves its parameters untouched.

output_schema
TemplatedText · object

A renderable text: its source plus the parameters its render takes.

EXACTLY ONE source is set — content (the text inline) or id (the id of a stored resource holding the text); neither and both are refused at construction. kwargs are the render parameters for the TEXT and apply either way, so moving a text from inline to stored (or back) leaves its parameters untouched.

state_binding
StateBinding · object | null

The optional binding a door carries: one or more :class:StateAttach entries. Frozen.

The same shape is stored on PresetBody/PresetSeed, TargetConversationConfig, HookRegister and ScheduleCreate, deposited on ToolInvocation through the ambient dispatch context, and repeated per node by a flow engine.

Response

Success.

data
PresetVersionSaveResult · object
required

A newly saved preset version row with the per-worker rebind fan-out report (fields merged, not nested).