---
title: "Re-enqueue many deliveries in one call"
method: POST
path: "/webhook_deliveries/bulk_replay"
tags: ["Webhooks"]
---

# Re-enqueue many deliveries in one call

`POST /webhook_deliveries/bulk_replay`

## Request

- Base URL: `https://thesignup.app/api/v1`
- URL: `https://thesignup.app/api/v1/webhook_deliveries/bulk_replay`
- Auth: HTTP bearer

Bulk form of POST /webhooks/deliveries/{id}/replay. Each matched delivery is reset to `pending` with attempt count 0; the dispatcher picks them up on its next tick. Always scoped to one endpoint and to the calling org.

## Request body

- BulkReplayRequest: Provide either `deliveryIds` or a non-empty `filter`. Supplying neither is rejected with 422: an unbounded request would re-deliver every row for the endpoint, which is not a designed action.
  - `endpointId` string, uuid, required: Required. Scopes the replay to one endpoint, so a filter-driven request can never fan out across every endpoint the org owns.
  - `deliveryIds` string[]: Explicit selection, 1–500 ids. An empty array is rejected rather than read as "none".
  - `filter` object: Filter-driven selection — the 'replay all matching' path. At least one of `status` or `eventType` must be non-empty.
    - `status` string[]
    - `eventType` string[]

## Response `200`

Deliveries re-enqueued

- BulkReplayResponse
  - `replayedCount` integer, required: How many deliveries were re-enqueued. Zero when nothing matched.

## Other responses

- `400`: Bad request — body or path could not be parsed
- `401`: Unauthenticated — credentials missing, malformed, invalid, or revoked
- `403`: Forbidden — credentials valid but lack the required scope
- `422`: Validation failed — request body / query / path is structurally wrong
- `429`: Rate limited or daily ceiling exceeded
- `500`: Internal server error

---

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