Get ai agent
Retrieve the fields shared by every agent type. Type-specific configuration is served by the typed resource, for example GET /ai-agents/inbox-manager/{id}.
Requires one of the following scopes: ai_agents:read, ai_agents:all, all:read, all:all
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the requested item
"01a0206f-ed6f-7791-9741-adac677a116c"
Response
The requested AI agent
The fields shared by every AI agent type
Unique identifier for the AI agent
"01a0206f-ab5d-7a94-b390-0e72d746d00a"
Name of the AI Agent
"Test AI Agent"
Status of the AI Agent
-1, 0, 1 1
Timestamp when the AI agent was created
"2026-08-20T18:29:44.413Z"
Timestamp when the AI agent was updated
"2026-08-20T18:29:44.413Z"
How much autonomy the agent runs with. Null for agent types that have no autonomy setting, and for agents whose mode is not configured yet.
copilot, fully_automatic, null "copilot"
Type of the AI Agent
1, 2, 3, 4, 6, 7, 8, 9, 10 1