Skip to main content
GET
Get Agent
Returns a simplified agent view. Instead of the low-level graph, attached_tools, oas, and fully-resolved tool schemas, the agent’s tools are surfaced as one flat tools array (see the AgentTool shape below). Use the Tools API to add or remove tools.

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
Emoji icon (e.g., 🚀)
string
Agent type (e.g., regular, manager)
string
ACTIVE (deployed) or INACTIVE
string
LLM provider (e.g., anthropic)
string
LLM model (e.g., claude-sonnet-4-6)
object
string[]
IDs of attached knowledge bases
string[]
Trigger source types (e.g., sdk, webhook, slack)
array
The agent’s attached tools, unified across kinds. 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.

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.