Get Agent Version

GET/v1/agents/{agent_id}/versions/{version}

Retrieve an immutable historical Agent snapshot. The version path value accepts either a version resource ID or a positive numeric version.

Path parameters

stringagent_idrequired

Stable identifier of the parent Agent.

string | integerversionrequired

Immutable version resource ID or positive numeric 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.../versions/2" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "id": "agent_01HqR2k7...",
  "type": "agent",
  "version": 2,
  "name": "Research Assistant",
  "description": "A general-purpose research Agent.",
  "model": {
    "id": "anthropic/claude-sonnet-5",
    "effort": {
      "type": "high"
    },
    "speed": "standard"
  },
  "system": "Always cite sources.",
  "tools": [],
  "mcp_servers": [],
  "skills": [],
  "handoffs": [],
  "metadata": {},
  "created_at": "2026-05-29T11:00:00Z",
  "updated_at": "2026-05-29T11:00:00Z",
  "archived_at": null
}