---
title: "POST /StartParticipantReplication"
method: POST
path: "/StartParticipantReplication"
---

# POST /StartParticipantReplication

`POST /StartParticipantReplication`

Starts replicating a publishing participant from a source stage to a destination stage.

## Request body

- object
  - `sourceStageArn` string, required — ARN of the stage where the participant is publishing.
  - `destinationStageArn` string, required — ARN of the stage to which the participant will be replicated.
  - `participantId` string, required — Participant ID of the publisher that will be replicated. This is assigned by IVS and returned by <a>CreateParticipantToken</a> or the <code>jti</code> (JWT ID) used to <a href="https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html#getting-started-distribute-tokens-self-signed">create a self signed token</a>.
  - `reconnectWindowSeconds` integer — If the participant disconnects and then reconnects within the specified interval, replication will continue to be <code>ACTIVE</code>. Default: 0.
  - `attributes` object — <p>Application-provided attributes to set on the replicated participant in the destination stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.</i> </p> <p>These attributes are merged with any attributes set for this participant when creating the token. If there is overlap in keys, the values in these attributes are replaced.</p>

## Response `200`

Success

- StartParticipantReplicationResponse

## Other responses

- `480` — ResourceNotFoundException
- `481` — ValidationException
- `482` — AccessDeniedException
- `483` — InternalServerException
- `484` — ServiceQuotaExceededException
- `485` — ConflictException
- `486` — PendingVerification

---

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