v1
protected
agents
Create Agent
Create a new agent.
post/v1/agents/
Request body
a2ui_enabledboolean nullable
Expose this agent over the A2UI protocol.
agent_type'stateless' | 'stateful'
DEPRECATED — stored and echoed back, but the runtime never reads it, so every agent behaves as 'stateless' regardless of this value. Conversation history does not currently survive across runs. Do not branch on this field.
descriptionstring
Short summary of what the agent does.
instructionstring
System prompt / behavioural instructions for the agent.
model_idstring nullable
UUID of a model instance in this workspace (see GET /v1/model-instances). Null means no model is bound yet and the agent cannot be run.
namestring required
Human-readable agent name (unique per workspace).
planningboolean nullable
Enable explicit planning step before execution.
skill_idsstring[] nullable
UUIDs of skills to attach to the agent.
Response
Successful Response
a2ui_enabledboolean nullable
agent_typestring
descriptionstring nullable
events_configobject nullable
idstring uuid required
instructionstring nullable
is_catalogboolean
model_idstring nullable
namestring required
planningboolean nullable
registry_item_idstring nullable
skillsobject[] nullable
slugstring required
statusstring required
update_availableboolean