List page versions, theme versions or the schedule

curl --request GET \
  --url https://studio.weaverse.io/api/v1/content/projects/{projectId}/versions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://studio.weaverse.io/api/v1/content/projects/{projectId}/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://studio.weaverse.io/api/v1/content/projects/{projectId}/versions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "object": "list",
  "data": [
    {
      "id": "clz8hst3b5d7f9h1j3l5n7p9",
      "pageId": "clz7pg9k2m4n6p8r0t2v4x6z",
      "projectId": "clz7prj0a1b2c3d4e5f6g7h8",
      "userId": null,
      "snapshot": {
        "pageData": {
          "id": "clz7pg9k2m4n6p8r0t2v4x6z",
          "name": "Home",
          "rootId": "root-1",
          "items": [
            {
              "id": "root-1",
              "type": "main",
              "children": [
                {
                  "id": "hero-1"
                }
              ],
              "data": {}
            },
            {
              "id": "hero-1",
              "type": "hero-image",
              "data": {
                "heading": "Summer collection",
                "height": "large"
              }
            }
          ],
          "expectedUpdatedAt": "2026-10-08T10:00:00.000Z"
        },
        "pageAssignment": {
          "type": "INDEX",
          "handle": "",
          "locale": ""
        }
      },
      "kind": "HISTORY",
      "draftBasePageUpdatedAt": null,
      "draftBaseProjectUpdatedAt": null,
      "publishedPageUpdatedAt": null,
      "publishedProjectUpdatedAt": null,
      "assignedType": "INDEX",
      "assignedHandle": "",
      "assignedLocale": "",
      "assignedMarket": null,
      "assignmentDeferred": false,
      "scheduleRevision": 0,
      "createdAt": "2026-10-08T10:05:00.000Z",
      "publishAt": null,
      "publishedAt": "2026-10-08T10:05:00.000Z",
      "status": "PUBLISHED"
    },
    {
      "id": "clz8hst6e8g0i2k4m6o8q0s2",
      "pageId": "clz7pg9k2m4n6p8r0t2v4x6z",
      "projectId": "clz7prj0a1b2c3d4e5f6g7h8",
      "userId": null,
      "snapshot": {
        "pageData": {
          "id": "clz7pg9k2m4n6p8r0t2v4x6z",
          "name": "Home",
          "rootId": "root-1",
          "items": [
            {
              "id": "root-1",
              "type": "main",
              "children": [
                {
                  "id": "hero-1"
                }
              ],
              "data": {}
            },
            {
              "id": "hero-1",
              "type": "hero-image",
              "data": {
                "heading": "Summer collection",
                "height": "large"
              }
            }
          ],
          "expectedUpdatedAt": "2026-10-08T10:00:00.000Z"
        },
        "pageAssignment": {
          "type": "INDEX",
          "handle": "",
          "locale": ""
        }
      },
      "kind": "HISTORY",
      "draftBasePageUpdatedAt": null,
      "draftBaseProjectUpdatedAt": null,
      "publishedPageUpdatedAt": null,
      "publishedProjectUpdatedAt": null,
      "assignedType": "INDEX",
      "assignedHandle": "",
      "assignedLocale": "",
      "assignedMarket": null,
      "assignmentDeferred": false,
      "scheduleRevision": 0,
      "createdAt": "2026-10-01T08:00:00.000Z",
      "publishAt": null,
      "publishedAt": null,
      "status": "ACTIVE"
    }
  ]
}

{
  "object": "error",
  "code": "UNAUTHORIZED",
  "message": "<string>",
  "status": 123,
  "details": "<unknown>"
}

{
  "object": "error",
  "code": "UNAUTHORIZED",
  "message": "<string>",
  "status": 123,
  "details": "<unknown>"
}

{
  "object": "error",
  "code": "UNAUTHORIZED",
  "message": "<string>",
  "status": 123,
  "details": "<unknown>"
}

Drafts and publishing

List page versions, theme versions or the schedule

Lists the project’s publish history. Which list you get depends on the query:

?pageId=<id>: that page’s versions, newest first: history versions and drafts that were published. Unpublished drafts are not listed; read the current draft with GET /projects/{projectId}/page-drafts/{pageId}. Takes precedence over kind.
?kind=theme: the project’s theme versions, newest first.
?kind=retired-pages: history versions whose page assignment no longer exists in this project, for recovery with restore. Each row includes page.name.
?kind=scheduled (default): the schedule. data is an object with pages (page versions that are SCHEDULED, PUBLISHED or CANCELLED, with their page), themes (theme versions in the same states) and deferredRecaptureCandidates (pageIds of deferred catch-all versions that still need a content recapture through PUT /versions/{versionId} with type: "deferred-page").

limit defaults to 30 and is capped at 100. It applies to ?pageId=, kind=theme and kind=retired-pages; the scheduled list is not limited. Any other kind value is 400.

Use a returned version id with /versions/{versionId} to read, reschedule, replace or cancel it, or with schedule, publish-now and restore.

Required scope: content:read

GET

projects

{projectId}

versions

List page versions, theme versions or the schedule

curl --request GET \
  --url https://studio.weaverse.io/api/v1/content/projects/{projectId}/versions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://studio.weaverse.io/api/v1/content/projects/{projectId}/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://studio.weaverse.io/api/v1/content/projects/{projectId}/versions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "object": "list",
  "data": [
    {
      "id": "clz8hst3b5d7f9h1j3l5n7p9",
      "pageId": "clz7pg9k2m4n6p8r0t2v4x6z",
      "projectId": "clz7prj0a1b2c3d4e5f6g7h8",
      "userId": null,
      "snapshot": {
        "pageData": {
          "id": "clz7pg9k2m4n6p8r0t2v4x6z",
          "name": "Home",
          "rootId": "root-1",
          "items": [
            {
              "id": "root-1",
              "type": "main",
              "children": [
                {
                  "id": "hero-1"
                }
              ],
              "data": {}
            },
            {
              "id": "hero-1",
              "type": "hero-image",
              "data": {
                "heading": "Summer collection",
                "height": "large"
              }
            }
          ],
          "expectedUpdatedAt": "2026-10-08T10:00:00.000Z"
        },
        "pageAssignment": {
          "type": "INDEX",
          "handle": "",
          "locale": ""
        }
      },
      "kind": "HISTORY",
      "draftBasePageUpdatedAt": null,
      "draftBaseProjectUpdatedAt": null,
      "publishedPageUpdatedAt": null,
      "publishedProjectUpdatedAt": null,
      "assignedType": "INDEX",
      "assignedHandle": "",
      "assignedLocale": "",
      "assignedMarket": null,
      "assignmentDeferred": false,
      "scheduleRevision": 0,
      "createdAt": "2026-10-08T10:05:00.000Z",
      "publishAt": null,
      "publishedAt": "2026-10-08T10:05:00.000Z",
      "status": "PUBLISHED"
    },
    {
      "id": "clz8hst6e8g0i2k4m6o8q0s2",
      "pageId": "clz7pg9k2m4n6p8r0t2v4x6z",
      "projectId": "clz7prj0a1b2c3d4e5f6g7h8",
      "userId": null,
      "snapshot": {
        "pageData": {
          "id": "clz7pg9k2m4n6p8r0t2v4x6z",
          "name": "Home",
          "rootId": "root-1",
          "items": [
            {
              "id": "root-1",
              "type": "main",
              "children": [
                {
                  "id": "hero-1"
                }
              ],
              "data": {}
            },
            {
              "id": "hero-1",
              "type": "hero-image",
              "data": {
                "heading": "Summer collection",
                "height": "large"
              }
            }
          ],
          "expectedUpdatedAt": "2026-10-08T10:00:00.000Z"
        },
        "pageAssignment": {
          "type": "INDEX",
          "handle": "",
          "locale": ""
        }
      },
      "kind": "HISTORY",
      "draftBasePageUpdatedAt": null,
      "draftBaseProjectUpdatedAt": null,
      "publishedPageUpdatedAt": null,
      "publishedProjectUpdatedAt": null,
      "assignedType": "INDEX",
      "assignedHandle": "",
      "assignedLocale": "",
      "assignedMarket": null,
      "assignmentDeferred": false,
      "scheduleRevision": 0,
      "createdAt": "2026-10-01T08:00:00.000Z",
      "publishAt": null,
      "publishedAt": null,
      "status": "ACTIVE"
    }
  ]
}

{
  "object": "error",
  "code": "UNAUTHORIZED",
  "message": "<string>",
  "status": 123,
  "details": "<unknown>"
}

{
  "object": "error",
  "code": "UNAUTHORIZED",
  "message": "<string>",
  "status": 123,
  "details": "<unknown>"
}

{
  "object": "error",
  "code": "UNAUTHORIZED",
  "message": "<string>",
  "status": 123,
  "details": "<unknown>"
}

Authorizations

Authorization

string

header

required

Bearer authentication: a shop API key (WEAVERSE_API_KEY), a scoped API key, a delegated MCP OAuth token, or (translation-unit routes only) a project-bound translation agent token. Scopes: content:read — Read projects, pages, theme settings, versions, drafts and translation units. content:write — Save drafts and make non-destructive edits (page items, metadata, SEO, assignments, languages, glossary). Never publishes or deletes. content:publish — Publish drafts, schedule/reschedule/cancel publications, restore versions, publish global sections. content:delete — Delete pages, global sections, languages, static keys, override reverts; required with project:manage for project deletion. project:manage — Create/copy/delete projects, settings, variants, hierarchy, backups, restore-as-new, previews, hostname policy. translations:read — Read translation units only (no general content access). translations:write — Apply translation units only; never mutates page content. A legacy unscoped API key keeps read/write/translation baseline access and every pre-scope endpoint, but never gains publish/delete/project-manage implicitly.

Path Parameters

projectId

string

required

Query Parameters

pageId

string

kind

enum<string>

Available options:

theme,

retired-pages,

scheduled

limit

integer

Maximum rows (default 30, max 100) for ?pageId=, kind=theme and kind=retired-pages; the scheduled list is not limited.

Required range: x <= 100

Response

Version list

The response is of type object.

Get started

Projects

Pages

Assignments

Theme settings

Languages and localization

Specification

Translations

Drafts and publishing

Global sections

Page settings

Project structure

Backups and portability

Previews and hostnames

List page versions, theme versions or the schedule

Authorizations

Path Parameters

Query Parameters

Response