Agents API

List Agents

GET /api/agents

Returns all agents for your organization.

Response

{
  "agents": [
    {
      "id": "uuid",
      "name": "Sarah's Claude Code",
      "acting_user": {
        "id": "uuid",
        "name": "Sarah Chen",
        "email": "sarah@company.com",
        "role": "IC",
        "level": "Senior"
      },
      "surface": "claude-code",
      "status": "active",
      "last_seen": "2025-01-15T10:30:00Z",
      "created_at": "2025-01-10T09:00:00Z"
    }
  ]
}

---

Create Agent

POST /api/agents

Create a new agent identity and generate an API key.

Request Body

Response

{
  "agent": {
    "id": "uuid",
    "name": "Sarah's Claude Code",
    "surface": "claude-code",
    "status": "active"
  },
  "api_key": "crtx_YOUR_KEY_HERE"
}

---

Get Agent

GET /api/agents/[id]

Response

{
  "agent": {
    "id": "uuid",
    "name": "Sarah's Claude Code",
    "acting_user": {
      "id": "uuid",
      "name": "Sarah Chen",
      "email": "sarah@company.com"
    },
    "surface": "claude-code",
    "status": "active",
    "last_seen": "2025-01-15T10:30:00Z"
  }
}

---

Delete Agent

DELETE /api/agents/[id]

Disconnects an agent. The agent key becomes invalid immediately.

Response

{
  "ok": true
}

Error Responses