---
title: "Bulk Replay Messages"
method: POST
path: "/api/v1/app/{app_id}/endpoint/{endpoint_id}/bulk-replay"
tags: ["Endpoint"]
---

# Bulk Replay Messages

`POST /api/v1/app/{app_id}/endpoint/{endpoint_id}/bulk-replay`

## Request

- Base URL: `https://api.eu.svix.com`
- URL: `https://api.eu.svix.com/api/v1/app/{app_id}/endpoint/{endpoint_id}/bulk-replay`
- Auth: HTTP bearer

Bulk replay messages sent to the endpoint.

Only messages that were created after `since` will be sent.
This will replay both successful, and failed messages

A completed task will return a payload like the following:
```json
{
  "id": "qtask_33qen93MNuelBAq1T9G7eHLJRsF",
  "status": "finished",
  "task": "endpoint.bulk-replay",
  "data": {
    "messagesSent": 2
  }
}
```

## Path parameters

- `app_id` string, required: The Application's ID or UID.
- `endpoint_id` string, required: The Endpoint's ID or UID.

## Headers

- `idempotency-key` string

## Request body

- BulkReplayIn
  - `channel` string, nullable
  - `eventTypes` string[], nullable
  - `since` string, date-time, required
  - `status` 0 | 1 | 2 | 3 | 4: The sending status of the message: - Success = 0 - Pending = 1 - Fail = 2 - Sending = 3 - Canceled = 4
  - `statusCodeClass` 0 | 100 | 200 | 300 | 400 | 500: The different classes of HTTP status codes: - CodeNone = 0 - Code1xx = 100 - Code2xx = 200 - Code3xx = 300 - Code4xx = 400 - Code5xx = 500
  - `tag` string, nullable
  - `until` string, date-time, nullable

## Response `202`

- ReplayOut
  - `id` string, required: The QueueBackgroundTask's ID.
  - `status` 'running' | 'finished' | 'failed', required
  - `task` 'endpoint.replay' | 'endpoint.recover' | 'application.stats' | 'message.broadcast' | 'sdk.generate' | 'event-type.aggregate' | 'application.purge_content' | 'endpoint.bulk-replay', required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too Many Requests

## Changes

- **2026-10-19** `cca56e67e5a4`: 1 info
  - added the required property `code` to the response with the `422` status

[Operation history](https://skmtc.dev/svix/apis/svix-api/changes/api/v1/app/:app_id/endpoint/:endpoint_id/bulk-replay/post.md)

---

[API](https://skmtc.dev/svix/apis/svix-api.md) - [All operations](https://skmtc.dev/svix/apis/svix-api/llms.txt) - [OpenAPI document](https://skmtc.dev/svix/apis/svix-api/revisions/21bb0f86a732?raw)