> ## Documentation Index
> Fetch the complete documentation index at: https://docs.falkordb.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Failover replica

> Fail over a replica of an Enterprise Single-Zone instance.

Promotes a healthy replica and replaces the failed one. Use this when a replica becomes unavailable.

## Authorization

<ParamField header="Cookie" type="string" required>
  Session cookie set by [Sign in](/api-reference/authentication/signin): `omnistrate_token=<jwt>`.
  Browsers send it automatically; other clients must forward it on every request.
</ParamField>

## Path parameters

<ParamField path="id" type="string" required>
  ID of the resource instance.
</ParamField>

## Query parameters

<ParamField query="subscriptionId" type="string">
  ID of the subscription that owns the instance.
</ParamField>

## Body

<ParamField body="failed_replica_action" type="string" required>
  Action to take on the failed replica.
</ParamField>

<ParamField body="failed_replica_id" type="string" required>
  ID of the failed replica to fail over from.
</ParamField>

## Response

Returns `202 Accepted` with an empty body when the operation is queued.

## Errors

See [Error](/api-reference/schemas#error) for the shared error response shape.