---
title: "replayEvents"
method: POST
path: "/v1/integrations/{integrationId}/events/replay"
tags: ["integrations"]
---

# replayEvents

`POST /v1/integrations/{integrationId}/events/replay`

Replay one or more events for a specific integration. Events will be re-processed with their original payloads but with a new correlation ID for traceability.

## Path parameters

- `integrationId` string, uuid, required

## Request body

- ReplayEventsRequest
  - `event_ids` string[], required — List of event IDs to replay. Maximum 100 events per request.

## Response `200`

Events replay initiated. Always 200 — per-event outcomes are reported in `results`, so inspect it (or compare `replayed` against the number of requested ids) rather than treating the status code as success.

- object
  - `replayed` integer, required — Number of events actually queued for re-processing.
  - `results` object[], required — One entry per requested event id, in request order.
    - `event_id` string, required — The requested (source) event ID.
    - `status` 'success' | 'queued' | 'skipped' | 'ignored' | 'not_found' | 'error', required — Outcome for this event. `success`/`queued` means it was enqueued for re-processing. `not_found` means no inbound event with that ID exists for the organization. `skipped` means it was deduplicated, `ignored` means no enabled use case matched it, and `error` means it could not be queued (see `message`).
    - `replay_event_id` string — The new event ID assigned to the replayed event. Use it to follow the replay in monitoring.
    - `message` string — Human-readable detail for this outcome.
  - `event_ids` string[] — List of event IDs for which replay was requested

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/epilot/apis/integration-toolkit-api.md) · [All operations](https://skmtc.net/epilot/apis/integration-toolkit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/integration-toolkit-api/revisions/68961a011db0/schema)