Skip to main content
GET
/
api
/
agents
/
{agent_uid}
Get agent
curl --request GET \
  --url https://api.example.com/api/agents/{agent_uid}
Returns a single agent with its triggers, tools, and configuration. The endpoint searches across all organizations the authenticated user belongs to.

Path parameters

agent_uid
string
required
UUID of the agent.

Response

{
  "status": "success",
  "status_code": 200,
  "data": {
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "organization_uid": "550e8400-e29b-41d4-a716-446655440000",
    "agent_type": "concierge",
    "name": "Communications Concierge",
    "description": "Handles inbound emails and triages based on intent",
    "instructions": "You are a communications concierge...",
    "status": "active",
    "created_by_uid": "660e8400-e29b-41d4-a716-446655440000",
    "notification_config": {
      "slack_channel_id": "C0123456789",
      "events": {
        "action_taken": true,
        "approval_required": true,
        "outcome": true,
        "error": true,
        "digest": false
      }
    },
    "runs_count": 42,
    "completed_count": 38,
    "failed_count": 4,
    "last_run": "2026-03-18T09:10:00Z",
    "last_run_status": "completed",
    "created_on": "2026-02-10T14:30:00Z",
    "updated_on": "2026-03-18T09:15:00Z",
    "triggers": [
      {
        "uid": "t1-uuid",
        "agent_uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "trigger_type": "email_received",
        "configuration": null,
        "is_active": true,
        "created_on": "2026-02-10T14:30:00Z",
        "updated_on": "2026-02-10T14:30:00Z"
      }
    ],
    "tools": [
      {
        "uid": "tool1-uuid",
        "agent_uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "tool_type": "send_email",
        "configuration": null,
        "is_active": true,
        "created_on": "2026-02-10T14:30:00Z",
        "updated_on": "2026-02-10T14:30:00Z"
      }
    ]
  }
}

Errors

StatusReason
404Agent not found or user lacks access