v34

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

Get an Agent

Retrieve an agent by ID.

get/v1/agents/{agentId}

Path parameters

agentIdstring required

The agent ID.

Response

The agent.

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