---
title: "Fail Over Shadow Link"
method: POST
path: "/v1/shadow-links/{name}/failover"
tags: ["Shadow Links (Data Plane)"]
---

# Fail Over Shadow Link

`POST /v1/shadow-links/{name}/failover`

Fail over a shadow link or a specific shadow topic within a link.

## Path parameters

- `name` string, required

## Request body

- FailOverBody
  - `shadow_topic_name` string

## Response `202`

Failover accepted and initiated

- V1FailOverResponse
  - `failed_over_topics` string[]
  - `name` string

## Other responses

- `401` — Unauthenticated.
- `500` — Internal Server Error. Reach out to support.
- `default` — An unexpected error response.

## Changes

- **2025-12-11** `0a5af046f9de` — 2 info
  - api tag `Shadow Links (Data Plane)` added
  - api tag `Shadow Links (Dataplane)` removed
- **2025-12-11** `d6b328d69cf2` — 1 info
  - endpoint added
- **2025-05-27** `dfa71f9d277e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/changes/v1/shadow-links/:name/failover/post.md)

---

[API](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api.md) · [All operations](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redpanda-data/redpanda-cloud-data-plane-api/revisions/7eef0bcc42e7/schema)