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

# run failover drill

`POST /platform/deployments/custom/{id}/failover-standby/drills`

## Request

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

Start a drill of the cold standby now. Manage scope. It backs up the primary, restores that copy over the standby, waits for the healthy redeploy the restore causes and records the verified copy with measured durations. The standby data is replaced; the primary is only read and no traffic moves. Read the drill until verified or failed. 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

- FailoverRunFailoverDrillInput

## Response `202`

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

- FailoverDrillResponse
  - `success` true, required
  - `data` FailoverDrill, required
    - `drill_id` string, required
    - `status` string, required
    - `triggered_by` string, required
    - `source_deployment_id` string, required
    - `target_deployment_id` string, required
    - `backup_id` string, nullable, required
    - `restore_id` string, nullable, required
    - `started_at` string, nullable, required
    - `finished_at` string, nullable, required
    - `failure` string, nullable, required
    - `receipt` object, 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)