Sign in
Agents

Retrieve an agent

Retrieves a reusable agent by ID. See agent configuration.

get/agents/{agent_id}

Path parameters

agent_idstring required

The ID of the reusable agent.

Response

The requested agent.

idstring required

The ID of the reusable agent.

object'agent' required

The object type. Always agent.

created_atinteger required

The Unix timestamp, in seconds, when the agent was created.

updated_atinteger required

The Unix timestamp, in seconds, when the agent was last updated.

namestring nullable required

A human-readable name for the agent, or null if it is unnamed.

metadataobject required

Custom string key-value pairs attached to the agent.

modelstring required

The requested model name used for inference.

service_tier'auto' | 'default' | 'flex' | 'priority' | 'fast' | 'ultrafast' required

The service-tier policy configured for an agent.

instructionsstring nullable required

Custom instructions appended to the agent's default base instructions.

Changes

Changed in 3 of the 163 revisions of this API.12