Get Agent

GET/v1/agents/{agent_id}

Retrieve the latest version of an agent, or request a specific historical version.

Path parameters

stringagent_idrequired

Unique agent identifier beginning with agent_.

Query parameters

Optional<integer>version

Historical version to retrieve. Omit this field to return the latest version.

Errors

401authentication_error

The API key is missing or invalid.

404not_found

The agent or requested version does not exist.

curl "https://api.sandbase.ai/v1/agents/agent_01HqR2k7..." \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "id": "agent_01HqR2k7...",
  "type": "agent",
  "version": 1,
  "name": "Research Assistant",
  "description": "A general-purpose research agent.",
  "model": {"id": "claude-sonnet-4", "effort": {"type": "high"}, "speed": "standard"},
  "system": "You are a research assistant...",
  "tools": [],
  "metadata": {},
  "archived_at": null,
  "created_at": "2026-05-29T10:00:00Z",
  "updated_at": "2026-05-29T10:00:00Z"
}