Skip to main content
GET
cURL
Returns the agent’s versions, newest first: every version saved with Save as new version, plus the live version. Each version appears once:
  • The live version shows its live save, marked with is_current: true.
  • Any other version shows its latest save. After you save edits into a version, its id here is the new save’s version_id.
Deleted versions aren’t listed. Pages hold up to 50 versions; use page_number and page_size, and read has_more to know whether to fetch the next page.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string<uuid>
required

The agent's id

Query Parameters

page_number
integer
default:1
Required range: x >= 1
page_size
integer
default:20
Required range: 1 <= x <= 50

Response

A page of agent versions

versions
object[]
current_version_id
string<uuid> | null

id of the live version

total
integer

Number of versions across all pages

page_number
integer
page_size
integer
has_more
boolean