Skip to main content
List Versions
Paged. This list used to return every row in one response. It now returns 20 by default - pass ?limit= up to 100, and ?cursor= with the previous response’s next_cursor for the next page. See Pagination.
Drafts and published versions share one number line, so split them by is_published rather than by number range.

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Path Parameters

agent_id
string
required

The agent's id, as GET /v1/agents returns it.

Query Parameters

cursor
string | null

Opaque cursor from a previous response's next_cursor; omit for the first page

limit
integer
default:20

Maximum records to return in one page.

Required range: 1 <= x <= 100

Response

Every version, newest first. Drafts and published versions share one number line — split them by is_published.

data
PublicVersionSummary · object[]
required

The rows on this page.

has_more
boolean
required

Whether another page exists. false on the last.

next_cursor
string | null

Pass back as ?cursor= for the next page; null on the last one. Opaque — do not parse or construct one. A cursor from a differently sorted list is refused with invalid_cursor rather than silently returning page 1.