Get Omni Agent
Get your Omni agent, the built-in agent every user has, resolved from the API key you call with.
id with any /v1/agents/{agent_id} route, for example Run Conversation Turn to talk to Omni or Get Agent Tasks to read its history.
Call it with your personal key, so the Omni returned is yours. A key with no user attached has no Omni, and the call returns 400. See Authentication for the two kinds of key.
Response
The same simplified agent view that Get Agent returns.agent_id to the other agent routes.DRAFT, ACTIVE (deployed) or INACTIVEanthropic)claude-sonnet-5)Errors
Authorizations
API Key for authentication
Response
Successful Response
Lean agent view exposing tools as one simple list, hiding low-level graph/oas internals.
Agent name.
Agent id.
Agent description.
Agent icon.
Agent type.
manager, regular, a2a, curl, orchestration Agent status.
DRAFT, ACTIVE, INACTIVE LLM provider.
LLM model.
Runtime: agno (built-in) or external-harness (Claude Code / Codex / OpenCode).
serverless or container.
serverless, container External harness settings (default CLI, per-CLI models, permission mode, per-turn resources ceilings); absent for built-in agents.
Agent instructions.
Attached knowledge base ids.
Trigger source types (sdk, webhook, slack, ...).
Tools attached to this agent.
Creation timestamp.
Creator user id.
Creator details.

