curl --request PUT \
  --url https://studio.weaverse.io/api/v1/content/versions/{versionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "page",
  "projectId": "clz7prj0a1b2c3d4e5f6g7h8",
  "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": ""
    }
  }
}
'

{
  "object": "version",
  "version": {
    "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": 2,
    "createdAt": "2026-10-08T10:05:00.000Z",
    "publishAt": "2026-12-01T09:00:00.000Z",
    "publishedAt": null,
    "status": "SCHEDULED"
  }
}

{
  "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>"
}

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

{
  "object": "error",
  "code": "STALE_PAGE",
  "message": "This page changed after it was loaded. Re-read and retry.",
  "status": 409,
  "details": {
    "pageId": "clz7pg9k2m4n6p8r0t2v4x6z"
  }
}

Drafts and publishing

Replace a version's pending content

Replaces the stored content of a version, typically one that is scheduled, so the new content goes live when the schedule fires. The schedule time stays the same. Send projectId and type in the body, not the query. type chooses the shape:

type: "page": a full page snapshot (pageData with name, rootId, items, and pageAssignment). snapshot.pageData is the page itself, not a { page } wrapper. The write is fenced on snapshot.pageData.expectedUpdatedAt: if the version’s page changed since then, the response is 409 STALE_PAGE and the stored snapshot stays the same.
type: "theme": a full theme snapshot (theme, recentColors, previewHost, defaultLocale), fenced on expectedProjectUpdatedAt. If the project revision moved, the response is 409 STALE_PROJECT.
type: "deferred-page": for a catch-all page version that has no live assignment yet. Send the page save payload as pageData (page and pageAssignment; page.id and page.expectedUpdatedAt are required), optional translations and staticTextChanges, the version’s current scheduleRevision as expectedScheduleRevision, and expectedProjectUpdatedAt. The response is version_recaptured, and its versionId may name a new successor version; use that id from then on.

Refusals (409 CONFLICT). Draft versions cannot be changed; save a new draft through PUT /projects/{projectId}/page-drafts/{pageId} instead. Sending page for a deferred version, or deferred-page for a normal one, is also refused. An invalid snapshot is 400.

Required scope: content:publish

PUT

versions

{versionId}

curl --request PUT \
  --url https://studio.weaverse.io/api/v1/content/versions/{versionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "page",
  "projectId": "clz7prj0a1b2c3d4e5f6g7h8",
  "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": ""
    }
  }
}
'

{
  "object": "version",
  "version": {
    "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": 2,
    "createdAt": "2026-10-08T10:05:00.000Z",
    "publishAt": "2026-12-01T09:00:00.000Z",
    "publishedAt": null,
    "status": "SCHEDULED"
  }
}

{
  "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>"
}

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

{
  "object": "error",
  "code": "STALE_PAGE",
  "message": "This page changed after it was loaded. Re-read and retry.",
  "status": 409,
  "details": {
    "pageId": "clz7pg9k2m4n6p8r0t2v4x6z"
  }
}

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

versionId

string

required

Body

application/json

Option 1
Option 2
Option 3

type

any

required

projectId

string

required

snapshot

object

required

expectedProjectUpdatedAt

string<date-time>

required

Response

Updated version

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

Replace a version's pending content

Authorizations

Path Parameters

Body

Response