curl --request POST \
--url https://studio.weaverse.io/api/v1/content/publish-versions/{versionId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"projectId": "clz7prj0a1b2c3d4e5f6g7h8",
"pageId": "clz7pg9k2m4n6p8r0t2v4x6z"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({projectId: 'clz7prj0a1b2c3d4e5f6g7h8', pageId: 'clz7pg9k2m4n6p8r0t2v4x6z'})
};
fetch('https://studio.weaverse.io/api/v1/content/publish-versions/{versionId}', 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/publish-versions/{versionId}"
payload = {
"projectId": "clz7prj0a1b2c3d4e5f6g7h8",
"pageId": "clz7pg9k2m4n6p8r0t2v4x6z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"object": "page_version_published",
"id": "clz9drf2h4j6l8n0p2r4t6v8",
"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": "DRAFT",
"draftBasePageUpdatedAt": "2026-10-08T10:00:00.000Z",
"draftBaseProjectUpdatedAt": "2026-10-08T09:00:00.000Z",
"publishedPageUpdatedAt": null,
"publishedProjectUpdatedAt": null,
"assignedType": "INDEX",
"assignedHandle": "",
"assignedLocale": "",
"assignedMarket": null,
"assignmentDeferred": false,
"scheduleRevision": 0,
"createdAt": "2026-10-08T10:12:00.000Z",
"publishAt": "2026-10-08T10:20:00.000Z",
"publishedAt": "2026-10-08T10:20:00.000Z",
"status": "PUBLISHED",
"pageUpdatedAt": "2026-10-08T10:20:00.000Z"
}{
"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": "The draft head or its live base moved; re-read and publish again",
"status": 409
}Publish a saved page draft
Makes one saved page draft live now. versionId is the versionId returned by PUT /projects/{projectId}/page-drafts/{pageId}. It uses the same promotion and cache fan-out as a Studio publish. Publishing is always explicit: content:write never implies it.
Preconditions
- The version must be a draft of
pageIdinprojectId, and it must still be the page’s current draft head. Otherwise the response is 404PAGE_NOT_FOUND. - The live page and project must still be at the revisions the draft was built on. If live moved, the response is 409
STALE_PAGE, nothing is published and the draft head stays in place. Re-read the draft, save it again and publish the new version.
Replacing a schedule. Set replaceScheduledVersionId to publish now in place of the page’s scheduled version. The scheduled version is closed in the same transaction (a scheduled draft returns to ACTIVE, a scheduled history version becomes CANCELLED), so the page is never left with neither a schedule nor a publication. If that id is no longer the page’s single scheduled version (it fired, was cancelled or was replaced), the response is 409 CONFLICT and nothing is published. A version cannot replace itself (400).
Response. The published version row (status: "PUBLISHED"), plus the new live pageUpdatedAt and, when the project revision advanced, projectUpdatedAt. If the content committed but cache invalidation failed, the response includes cacheDelivery: "degraded"; the content is live and edge delivery is retried automatically, so do not publish again.
Required scope: content:publish
curl --request POST \
--url https://studio.weaverse.io/api/v1/content/publish-versions/{versionId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"projectId": "clz7prj0a1b2c3d4e5f6g7h8",
"pageId": "clz7pg9k2m4n6p8r0t2v4x6z"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({projectId: 'clz7prj0a1b2c3d4e5f6g7h8', pageId: 'clz7pg9k2m4n6p8r0t2v4x6z'})
};
fetch('https://studio.weaverse.io/api/v1/content/publish-versions/{versionId}', 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/publish-versions/{versionId}"
payload = {
"projectId": "clz7prj0a1b2c3d4e5f6g7h8",
"pageId": "clz7pg9k2m4n6p8r0t2v4x6z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"object": "page_version_published",
"id": "clz9drf2h4j6l8n0p2r4t6v8",
"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": "DRAFT",
"draftBasePageUpdatedAt": "2026-10-08T10:00:00.000Z",
"draftBaseProjectUpdatedAt": "2026-10-08T09:00:00.000Z",
"publishedPageUpdatedAt": null,
"publishedProjectUpdatedAt": null,
"assignedType": "INDEX",
"assignedHandle": "",
"assignedLocale": "",
"assignedMarket": null,
"assignmentDeferred": false,
"scheduleRevision": 0,
"createdAt": "2026-10-08T10:12:00.000Z",
"publishAt": "2026-10-08T10:20:00.000Z",
"publishedAt": "2026-10-08T10:20:00.000Z",
"status": "PUBLISHED",
"pageUpdatedAt": "2026-10-08T10:20:00.000Z"
}{
"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": "The draft head or its live base moved; re-read and publish again",
"status": 409
}Authorizations
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
Body
Response
Published receipt
The response is of type object.
Was this page helpful?