Skip to main content
POST
Roll the published head back to a retained prior revision (expected-head CAS)

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Path Parameters

projectId
string
required
serviceId
string
required

Body

application/json
expectedHead
object
required

The published head the caller observed. The CAS wins only if it still matches (revisionId + generation).

Response

Outcome

Typed operational outcome. ok:false carries a closed code (HEAD_CONFLICT with current, ARTIFACT_NOT_SEALED, SERVICE_NOT_READY, NOT_A_PRIOR_HEAD, SERVING_PUBLISHED_HEAD, STALE_GENERATION with currentGeneration, GUEST_UNAVAILABLE, GUEST_STOP_FAILED); a lost CAS is reported, never retried blindly.

success
boolean
Example:

true

ok
boolean
code
string | null
action
enum<string> | null
Available options:
publish,
rollback
publishedHead
object
current
object
url
string | null

exact public site URL of the new head (null when the content origin is unconfigured)