OMomnistack-sh
Agents

Retrieve an agent

Changed on

Retrieves a reusable agent by ID. See agent configuration.

get/agents/{agent_id}

Request

  • Base URL
    https://api.openai.com/v1
  • URL
    https://api.openai.com/v1/agents/{agent_id}
  • Auth
    HTTP bearer

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