Nimbu Developer Docs
ReferencePages

Publish a page draft

POST
/pages/{page_id}/draft/publish

Applies the draft to the live page and returns the Page.

Responses

  • 200 — live page after publish
  • 409 draft_base_changed when the live page changed since the draft was based — send confirm: true to force
  • 422 if publish failed
  • 404 if no draft

Authorization

AuthorizationBearer <token>

Personal access token tied to a user account. Requires the X-Nimbu-Site header to scope requests.

In: header

X-Nimbu-Site<token>

Identifier of the site context when authenticating with a personal access token.

In: header

Path Parameters

page_id*string

Page identifier or draft-only id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/pages/string/draft/publish" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "66f1a2b3c4d5e6f7a8b9c0d0",
  "title": "Draft Title"
}
{
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "code": "draft_base_changed",
  "message": "Live page changed after this draft was based on it; confirm publish to replace live content."
}