Generate experiences with Puck AI
Read docs
CloudAPI referencecloud-clientServer APIspages.listVersions

pages.listVersions

Puck Pages is experimental and may change in a future release.

List all versions of a page.

await puck.pages.listVersions("page_123");
// { results: [{ id: "page_123", path: "/about", version: 1, publishedVersion: null, status: "draft", createdAt: "2026-10-30T12:00:00.000Z", createdBy: "user_123" }], count: 1, hasMore: false }

Returns a PageList containing the pages at each version, and pagination data.

Args

ParamExampleTypeStatus
id"page_123"StringRequired
params{ offset: 25 }Object-
options{ auth: {} }Object-

id

The page’s id.

params

ParamExampleTypeStatus
offsetoffset: 25Number-
limitlimit: 10Number-

offset

How many versions to skip. Defaults to 0.

const { results } = await puck.pages.listVersions("page_123", { offset: 25 });

limit

How many versions to return, up to 100. Defaults to 25.

const { results } = await puck.pages.listVersions("page_123", { limit: 10 });

options

Set the request options for this call.