Skip to main content
GET
Retrieve an agent
Retrieves the complete Agent object, including its full specification: environments, skills, instructions, and subagent configuration. Returns the Agent object if the name is valid and you have access. Returns 404 otherwise.

Path parameters

string
required
The agent’s name (e.g., h/web or my-custom-bot). Slash-containing names are supported.

Query parameters

boolean
default:"false"
When true, string references in environments, skills, and subagents are expanded into their full specs in the response. When false (the default), they are returned as stored, keeping catalog ids as plain strings.

Examples

Retrieve an H catalog agent

Response

Retrieve a custom agent


Use case: inspect before using

Before using an agent in a session, you can inspect its capabilities:

Errors