List Agent Versions

GET/v1/agents/{agent_id}/versions

List immutable agent configuration snapshots, ordered from newest version to oldest.

Path parameters

stringagent_idrequired

Unique agent identifier beginning with agent_.

Query parameters

Optional<integer>limit

Number of versions to return. Accepts values from 1 to 100.

Default: 20

Optional<string>page

Opaque cursor returned in a previous response's next_page field.

Immutable Agent projections

Each item is the full Agent projection at that immutable version. No-op updates do not create a version.

Errors

401authentication_error

The API key is missing or invalid.

404not_found

The agent does not exist.

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

Response200 OK

{
  "data": [
    {
      "id": "agent_01HqR2k7...",
      "type": "agent",
      "version": 2,
      "name": "Research Assistant",
      "model": {"id": "claude-sonnet-4", "effort": {"type": "high"}, "speed": "standard"},
      "system": "Always cite sources.",
      "created_at": "2026-05-29T11:00:00Z"
    }
  ],
  "next_page": null
}