List Agents

GET/v1/agents

List Agents owned by your organization. Results use cursor pagination: pass last_id as after while has_more is true.

Query parameters

Optional<string>status

active, archived, or all. Other values return 400.

Default: active

Optional<integer>limit

Page size from 1 to 100. Values outside the range return 400.

Default: 20

Optional<string>after

Cursor. Pass last_id from the previous page.

Optional<string>order

asc or desc by creation time.

Default: desc

curl -X GET "https://api.sandbase.ai/v1/agents?status=active&limit=20" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "object": "list",
  "data": [
    {
      "id": "agt_8c1f2b9e-3d4a-4f6b-9c2e-1a7d5e3b4c60",
      "object": "agent",
      "name": "Research assistant",
      "model": "deepseek/deepseek-v4-flash",
      "instructions": "Answer with cited sources.",
      "tools": [],
      "text": {
        "format": {
          "type": "text"
        },
        "verbosity": "medium"
      },
      "reasoning": {
        "effort": null,
        "summary": null
      },
      "service_tier": "auto",
      "multi_agent": {
        "enabled": false,
        "max_concurrent_subagents": null
      },
      "visibility": "private",
      "status": "active",
      "version": 1,
      "row_version": 1,
      "projection_status": "ready",
      "runtime_profile": "codex",
      "description": "",
      "metadata": {
        "team": "research"
      },
      "mcp_connections": [],
      "skills": [],
      "created_at": 1791273600,
      "updated_at": 1791273600,
      "archived_at": null
    }
  ],
  "has_more": false,
  "first_id": "agt_8c1f2b9e-3d4a-4f6b-9c2e-1a7d5e3b4c60",
  "last_id": "agt_8c1f2b9e-3d4a-4f6b-9c2e-1a7d5e3b4c60"
}