# Confluent Switchover Pairs (switchover/v1) API

**Canonical:** https://apis.io/apis/confluent/confluent-switchover-pairs-switchover-v1-api/  
**Provider:** Confluent — https://apis.io/providers/confluent/  
**Base URL:** https://api.confluent.cloud  
**Documentation:** https://www.confluent.io/

Confluent Switchover Pairs (switchover/v1) API is one of 152 APIs that [Confluent](https://apis.io/providers/confluent/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Switchover Pairs (switchover/v1). The published artifact set on APIs.io includes an OpenAPI specification.

[![Early Access](https://img.shields.io/badge/Lifecycle%20Stage-Early%20Access-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy) [![Request Access To Switchover API (Kafka Disaster Recovery)](https://img.shields.io/badge/-Request%20Access%20To%20Switchover%20API%20%28Kafka%20Disaster%20Recovery%29-%23bc8540)](mailto:ccloud-api-access+switchover-v1-early-access@confluent.io?subject=Request%20to%20join%20switchover/v1%20API%20Early%20Access&body=I%E2%80%99d%20like%20to%20join%20the%20Confluent%20Cloud%20API%20Early%20Access%20for%20switchover/v1%20to%20provide%20early%20feedback%21%20My%20Cloud%20Organization%20ID%20is%20%3Cretrieve%20from%20https%3A//confluent.cloud/settings/billing/payment%3E.) `SwitchoverPair` represents a cluster-level Disaster Recovery pairing between two Kafka clusters in different regions of the same environment. Exactly one member is active at any time; the other is passive and kept in sync via a bidirectional cluster link. The API allows you to list, create, read, update, and delete switchover pairs, and to trigger a failover (promotion of the passive member) via the `:failover` operation. Related guide: [Disaster Recovery for Kafka in Confluent Cloud](https://docs.confluent.io/cloud/current/clusters/cluster-linking/index.html). ## The Switchover Pairs Model <SchemaDefinition schemaRef="#/components/schemas/switchover.v1.SwitchoverPair" />

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/switchover/v1/switchover-pairs` | List of Switchover Pairs |
| POST | `/switchover/v1/switchover-pairs` | Create a Switchover Pair |
| GET | `/switchover/v1/switchover-pairs/{id}` | Read a Switchover Pair |
| PUT | `/switchover/v1/switchover-pairs/{id}` | Update a Switchover Pair |
| DELETE | `/switchover/v1/switchover-pairs/{id}` | Delete a Switchover Pair |
| POST | `/switchover/v1/switchover-pairs/{id}:failover` | Trigger a failover on a switchover pair |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/confluent/refs/heads/main/openapi/confluent-switchover-pairs-switchover-v1-api-openapi.yml

## Other Confluent APIs (12)

- [Confluent](https://apis.io/apis/confluent/confluent/)
- [Confluent Managed MCP Servers](https://apis.io/apis/confluent/confluent-mcp/)
- [Confluent API Keys API](https://apis.io/apis/confluent/confluent-api-keys-api/)
- [Confluent Clusters API](https://apis.io/apis/confluent/confluent-clusters-api/)
- [Confluent Consumer Groups API](https://apis.io/apis/confluent/confluent-consumer-groups-api/)
- [Confluent Environments API](https://apis.io/apis/confluent/confluent-environments-api/)
- [Confluent Partitions API](https://apis.io/apis/confluent/confluent-partitions-api/)
- [Confluent Service Accounts API](https://apis.io/apis/confluent/confluent-service-accounts-api/)
- [Confluent Topics API](https://apis.io/apis/confluent/confluent-topics-api/)
- [Confluent Access Points (networking/v1) API](https://apis.io/apis/confluent/confluent-access-points-networking-v1-api/)
- [Confluent ACL (v3) API](https://apis.io/apis/confluent/confluent-acl-v3-api/)
- [Confluent Agents (sql/v1) API](https://apis.io/apis/confluent/confluent-agents-sql-v1-api/)

## Tags

Switchover Pairs (switchover/v1)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/confluent/confluent-switchover-pairs-switchover-v1-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/confluent/.