Skip to main content
GET
Retrieve an agent
Retrieves one agent’s full specification, including pre-built h/ agents. Returns the agent object.

Path parameters

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

Query parameters

integer
Read this revision instead of the latest. List them with List revisions.
boolean
default:"false"
When true, string references in environments, skills, and subagents are expanded into their full specs. When false, they are returned as stored.

Response

The agent object, also returned by create, list, update, and patch. Field constraints are on Create an agent. The ETag response header holds the revision you read, for example "3". Send it back as If-Match to update only if nobody changed the agent since. A resolve=true read has no ETag, since it also reflects the environments, skills, and subagents it expands.
string
Catalog identifier. h/ names are H’s reserved, read-only agents.
string
What the agent does.
array
Catalog id strings or inline environment specs.
string | null
Holo model id. null uses the default, holo4-27b.
string | null
disabled, low, medium, or xhigh. null uses the model’s default.
string | null
Steering text appended to the system prompt.
array | null
Agents this one can delegate to: catalog names or inline agent specs.
array | null
Catalog skill names or inline skill specs.
object | null
JSON Schema of the final answer. null returns free-form text.
object[] | null
Custom tools executed by your code.

Examples

Response

Errors