Platform

pair failover standby

Pair two existing compatible apps on this account in different reported countries. Managed countries come from internal inventory; an external country is declared by the customer and is not verified by Impreza. Deploy scope. Does not provision servers, copy data or switch traffic. First create the reviewed catalog standby with impreza_deploy_catalog_app and standby:true, without domain or onion. The standby must have no public route or onion. Failover moves only a hostname in the managed zone or a public .onion: custom domains, private onion services, database bindings and dedicated servers are not supported. 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/deployments/custom/{id}/failover-standby

Request

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

Path parameters

idstring required

Request body

target_deployment_idstring required
mode'cold' required

Response

Pair or review prepared; no automatic traffic switch.

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.