Get Agent
REST API - Agents
Get Agent
Retrieve an agent in a simplified view — its attached tools as one flat list, plus core configuration.
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 INACTIVEstring
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
API Key for authentication
Path Parameters
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.
Available options:
manager, regular, a2a, curl, orchestration Agent status.
Available options:
DRAFT, ACTIVE, INACTIVE LLM provider.
LLM model.
Agent instructions.
Attached knowledge base ids.
Trigger source types (sdk, webhook, slack, ...).
Tools attached to this agent.
Creation timestamp.
Creator user id.
Creator details.

