Platform

apply failover

After explicit user confirmation, submit confirm=true and the exact review_digest. Manage scope. Stops and fences the source writer, transfers the managed hostname and activates the restored standby; a public onion is sealed to the standby, published there and its old copy purged. Interrupts traffic and may lose changes since the copied backup. Acceptance only queues work; read the receipt to verify. Repeating the same accepted review returns its receipt. Hosted MCP requires an account credential without resource confinement. Available only when the failover_enabled feature gate is enabled. Resources must belong to the authenticated account; confined credentials are rejected. A disabled gate returns 404. Review validity, same-account pairing and current state are checked again by the server.

post/platform/failover-cutovers/{id}/apply

Request

Base URL: https://api.imprezahost.com/v1
URL: https://api.imprezahost.com/v1/platform/failover-cutovers/{id}/apply
Auth: API key in header X-API-Key and API key in header X-API-Secret

Path parameters

idstring required

Request body

review_digeststring required

confirmtrue required

Response

Operation enqueued; poll the saved receipt. This response does not certify recovery.

successtrue required

Example response

{
  "meta": {
    "request_id": "req_a1b2c3d4e5f6g7h8",
    "timestamp": "2026-03-30T14:05:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.