---
title: "pair failover standby"
method: POST
path: "/platform/deployments/custom/{id}/failover-standby"
tags: ["Platform"]
---

# pair failover standby

`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`

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.

## Path parameters

- `id` string, required

## Request body

- FailoverPairFailoverStandbyInput
  - `target_deployment_id` string, required
  - `mode` 'cold', required

## Response `201`

Pair or review prepared; no automatic traffic switch.

- FailoverPairResponse
  - `success` true, required
  - `data` FailoverPair, required
    - `source_deployment_id` string, required
    - `target_deployment_id` string, required
    - `mode` 'cold', required
    - `state` string, required
    - `source_country` string, required
    - `target_country` string, required
    - `source_country_basis` string, required
    - `target_country_basis` string, required
    - `source_country_notice` string, nullable, required
    - `target_country_notice` string, nullable, required
  - `meta` Meta, required
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `400`: Malformed arguments, missing explicit confirmation, or invalid digest
- `401`: Authentication required
- `403`: Insufficient scope, account ownership, or unsupported credential confinement
- `404`: Gate disabled or resource not found on this account
- `409`: State, replay, concurrency, or review conflict
- `422`: Unsupported deployment or unmet workflow prerequisite
- `503`: Failover service unavailable

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)