Get an agent
Retrieve an agent and its schema details.
Agents can have both a live published version and a draft version with newer
unpublished changes. Use the version parameter to choose which state to return.
Authorizations
Path Parameters
The ID of the agent to retrieve.
Query Parameters
Version of the agent to retrieve. Use published for the live version, or draft for the latest unpublished changes for the same agent. Defaults to published.
published, draft Response
Successful Response
Detailed information for an agent.
Unique ID for the agent.
Unique ID of the organization that owns the agent.
Display name of the agent.
Current status of the agent.
draft, published, unknown When the agent was created.
Short description of the agent, if provided.
Input and output schemas for this agent. Omitted while the agent's graph cannot be previewed (e.g. an empty or structurally-invalid draft); check validation to see what needs fixing.
Validation report for the agent's graph, when available. Use validation.valid to check the agent is publishable.