---
title: "POST /v1beta/{tenantId}/block/replications/{replicationId}/failover"
method: POST
path: "/v1beta/{tenantId}/block/replications/{replicationId}/failover"
tags: ["Block Replications"]
---

# POST /v1beta/{tenantId}/block/replications/{replicationId}/failover

`POST /v1beta/{tenantId}/block/replications/{replicationId}/failover`

Failover Replication.

## Request body

- object — FailoverReplicationSpec represents failover replication relationship between the volumes on the primary and secondary sites.
  - `allowAttachedVolume` boolean
  - `secondaryBackendId` string

## Response `202`

Accepted

## Other responses

- `400` — BadRequest
- `401` — NotAuthorized
- `403` — Forbidden
- `404` — The resource does not exist
- `500` — An unexpected error occured.

## Changes

- **2019-11-06** `fd0669e1e56f` — 6 info
  - added optional request body
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - …2 more
- **2018-05-04** `3a7682f5369d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/sodafoundation/apis/soda-api/changes/v1beta/:tenantId/block/replications/:replicationId/failover/post.md)

---

[API](https://skmtc.dev/sodafoundation/apis/soda-api.md) · [All operations](https://skmtc.dev/sodafoundation/apis/soda-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sodafoundation/apis/soda-api/revisions/62ce0f6c94b4?raw)