v34

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-215423105.7 KB

Create an Agent

Create a reusable agent. An agent defines a systemPrompt and resultSchema that guide its behavior for every run. Only name is required; an agent created with no systemPrompt behaves like an unconfigured run.

post/v1/agents

Request body

namestring required

Human-readable name for the agent. Used to identify the agent in the dashboard and API responses.

systemPromptstring

System prompt that steers the agent's behavior on every run that uses this agent.

resultSchemaobject

An optional JSON Schema object. If provided, runs that reference this agent will aim to return a result that conforms to this schema when they complete. Can be overridden per run by passing resultSchema on the run request.

Response

The agent has been created.

agentIdstring required

Unique identifier for the agent. Use this value as agentId when creating an agent run.

namestring required

Human-readable name for the agent. Used to identify the agent in the dashboard and API responses.

systemPromptstring

System prompt applied to every run that uses this agent.

resultSchemaobject

JSON Schema that runs referencing this agent will aim to conform their result to. Can be overridden per run by passing resultSchema on the run request.

createdAtstring date-time required

updatedAtstring date-time required