v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01251238661.6 KB

protected

agents

Create Agent

Create a new agent.

post/v1/agents/

a2ui_enabledboolean nullable

Expose this agent over the A2UI protocol.

agent_type'stateless' | 'stateful'

'stateless' (each request independent) or 'stateful' (maintains conversation context across runs).

descriptionstring

Short summary of what the agent does.

instructionstring

System prompt / behavioural instructions for the agent.

model_idstring required

Model instance UUID or provider model identifier (e.g. 'gpt-4o', 'claude-3-5-sonnet').

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.

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