---
title: "POST /v1/projects/{project}/instances/{instance}/failover"
method: POST
path: "/v1/projects/{project}/instances/{instance}/failover"
tags: ["instances"]
---

# POST /v1/projects/{project}/instances/{instance}/failover

`POST /v1/projects/{project}/instances/{instance}/failover`

Initiates a manual failover of a high availability (HA) primary instance to a standby instance, which becomes the primary instance. Users are then rerouted to the new primary. For more information, see the [Overview of high availability](https://cloud.google.com/sql/docs/mysql/high-availability) page in the Cloud SQL documentation. If using Legacy HA (MySQL only), this causes the instance to failover to its failover replica instance.

## Path parameters

- `project` string, required
- `instance` string, required

## Request body

- InstancesFailoverRequest — Instance failover request.
  - `failoverContext` FailoverContext — Database instance failover context.
    - `kind` string — This is always `sql#failoverContext`.
    - `settingsVersion` string, int64 — The current settings version of this instance. Request will be rejected if this version doesn't match the current settings version.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/sqladmin.md) · [All operations](https://skmtc.net/google/apis/sqladmin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/sqladmin/versions/e9eef8a2afcd/schema)