Skip to main content
POST
Validate a preset draft (dry-run)

Authorizations

x-api-key
string
header
required

Body

application/json

A preset validation (dry-run) request — the full create field set. When a preset named name already exists the door validates a NEW VERSION: then base_tool / description carry forward from the active body (a provided value that differs is rejected) and any absent field merges from it, exactly as the save-version route merges.

name
string
required
base_tool
string | null
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
PresetValidateVerdict · object
required

A preset draft validation verdict — valid is the absence of an error (both outcomes answer 200).