v84

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0985248447.1 KB
Agents

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.

get/v1/agents/{agent_id}

Path parameters

agent_idstring uuid required

The ID of the agent to retrieve.

The ID of the agent to retrieve.

Query parameters

version'published' | 'draft'

Version selector for retrieving a specific agent.

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.

Response

Successful Response

idstring uuid required

Unique ID for the agent.

organization_idstring uuid required

Unique ID of the organization that owns the agent.

namestring required

Display name of the agent.

status'draft' | 'published' | 'unknown' required

Current availability status for an agent.

created_atstring date-time required

When the agent was created.

descriptionstring nullable

Short description of the agent, if provided.