List Agent Versions

GET/v1/agents/{agent_id}/versions

List version snapshots with offset pagination. Each item contains the saved configuration document, checksum, optional note, and an RFC 3339 created_at.

Path parameters

stringagent_idrequired

Agent ID (agt_ prefix).

Query parameters

Optional<integer>limit

Page size. Values above 200 are capped at 200.

Default: 20

Optional<integer>offset

Number of records to skip.

Default: 0

curl -X GET "https://api.sandbase.ai/v1/agents/agt_8c1f2b9e-3d4a-4f6b-9c2e-1a7d5e3b4c60/versions?limit=20&offset=0" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "data": [
    {
      "version": 2,
      "agent": {
        "name": "Research assistant",
        "model": "deepseek/deepseek-v4-flash",
        "instructions": "Answer in five bullet points with cited sources."
      },
      "checksum": "d04d38eb890a1273fa7965a6a7cdc2426232326e43b901d1aad3ed669455acbf",
      "created_at": "2026-10-06T08:00:00.000Z"
    }
  ],
  "total": 2,
  "limit": 20,
  "offset": 0
}