Admin Publish Page
Atomically publish a page’s draft tree with OCC via If-Match.
The caller MUST supply the If-Match request header containing the
draft_version value it observed when reading the draft. If the
header is absent the request is rejected with 428 Precondition Required.
If the provided version no longer matches the page (a concurrent edit
occurred) the request is rejected with 409 Conflict so the caller can
re-read the draft and retry.
On success, the page’s published sections and gate index are atomically
written and published_revision is incremented (R5 revision-flip-last).
Error codes
428 precondition_required — If-Match header absent.
400 invalid_if_match — If-Match value is not an integer.
404 page_not_found — page does not exist.
409 stale_draft — If-Match version does not match.
422 compiler_invariant — a non-public node is under a NULL gate (R3).
422 unknown_access_rule — a gated node references a missing rule.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Response
Successful Response
Top-level JSON:API response envelope for POST .../publish.
JSON:API resource object for a page publish outcome.