Skip to main content
GET
Get Agent
Returns a simplified agent view (SimplifiedAIAgent), not the full object that Create Agent returns. Instead of the low-level graph, attached_tools, oas, and fully-resolved skill schemas, the agent’s attached skills are surfaced as one flat tools array (see the AgentTool shape below). Use Add Agent Tool and Remove Agent Tool to change them. Fields such as skills, gated_commands, secret_bindings, can_self_schedule and default_user_id are not part of this view; they come back on the full object that Create Agent and Update Agent return.

Path Parameters

string
required
Unique identifier of the agent (UUID format)

Response

string
Agent UUID
string
Display name
string
What the agent does (auto-generated on deploy from instructions)
string
Icon shown next to the agent name (default xpi:workflow:dusk, or an emoji)
string
Agent type: manager, regular, a2a, curl or orchestration
string
DRAFT, ACTIVE (deployed) or INACTIVE
string
LLM provider (e.g., anthropic)
string
LLM model (e.g., claude-sonnet-5)
string
How the agent runs: external-harness (a coding CLI chosen by harness_settings.default_cli) or agno (the built-in loop)
string
serverless or container
object | null
Runtime settings of an external-harness agent; null for agno.
object
string[]
IDs of attached knowledge bases
string[]
Trigger source types (e.g., sdk, webhook, slack)
array
The agent’s attached skills, unified across kinds; capabilities the runtime provides on its own do not appear here. Each item is an AgentTool:
string
ISO 8601 creation timestamp
string | null
UUID of the creating user
object | null
Resolved creator details (null when unavailable; null-check before reading).

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

agent_id
string
required

Response

Successful Response

Lean agent view exposing tools as one simple list, hiding low-level graph/oas internals.

name
string
required

Agent name.

id
string | null

Agent id.

description
string | null

Agent description.

icon
string | null

Agent icon.

type
enum<string> | null

Agent type.

Available options:
manager,
regular,
a2a,
curl,
orchestration
status
enum<string> | null

Agent status.

Available options:
DRAFT,
ACTIVE,
INACTIVE
model_provider
string | null

LLM provider.

model_name
string | null

LLM model.

framework
string | null

Runtime: agno (built-in) or external-harness (Claude Code / Codex / OpenCode).

deployment_type
enum<string> | null

serverless or container.

Available options:
serverless,
container
harness_settings
HarnessSettings · object | null

External harness settings (default CLI, per-CLI models, permission mode, per-turn resources ceilings); absent for built-in agents.

instructions
AIAgentInstructions · object | null

Agent instructions.

knowledge_base_ids
string[] | null

Attached knowledge base ids.

source_node_types
string[] | null

Trigger source types (sdk, webhook, slack, ...).

tools
AgentTool · object[]

Tools attached to this agent.

created_at
string<date-time> | null

Creation timestamp.

created_by
string | null

Creator user id.

created_by_details
CreatedByDetails · object | null

Creator details.