Voice AgentsAgentsBuiltins

Get Agent Builtin

Fetch one builtin instance by ID.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

idstringRequired
builtinIdstringRequired

Response

The builtin instance.
idstring
Opaque builtin instance ID.
tenant_idstring
The workspace owning this instance.
agent_idstring
The agent this instance is bound to.
builtinstring

Identifier of a worker-resident system builtin. New entries are added together on the server (a new tool_builtin_<name>.go file) and worker (tools/builtins/<name>.py) - the 2-file rule AIS-3053 pins. Customers read the catalogue from GET /v1/agents/tools/system-builtins rather than depending on this string set staying stable across releases.

namestring

LLM-facing tool name. Unique within the agent’s builtin set.

descriptionstring

LLM-facing one-line description of when to call the tool.

enabledboolean
When false, the instance is persisted but skipped at dispatch.
created_atdatetime
updated_atdatetime
configmap from strings to any or null

Per-instance configuration shape. The schema depends on builtin — see the per-builtin contracts under /contracts/tools/system_*.schema.json. Null when the builtin takes no instance-level config.

paramslist of maps from strings to any or null

Per-call parameter schema fragment merged into the model’s tool spec. Each entry is one parameter descriptor (the per-builtin contract pins the exact shape). Null when the builtin takes no caller arguments.

Errors

401
Unauthorized Error
404
Not Found Error