---
title: "Replay an endpoint's deliveries"
method: POST
path: "/webhooks/{id}/replay"
tags: ["Webhooks"]
---

# Replay an endpoint's deliveries

`POST /webhooks/{id}/replay`

## Request

- Base URL: `https://api.rizamo.com/v1`
- URL: `https://api.rizamo.com/v1/webhooks/{id}/replay`
- Auth: HTTP bearer

Sends again, once each and now, the endpoint's deliveries made between `since` and `until` (within the last 30 days): the failed ones, or every one with `status` all. Each keeps its `webhook-id` and goes to the endpoint's `url` as it is now. Deliveries the endpoint no longer takes are skipped, and those still waiting for a retry are not replayed. Up to 1,000 a call, in the order they were made, and within the team's 5,000 replays an hour (429 once none are left); `more` says the range holds more, and `nextCursor` continues after the last one this call looked at. One range at a time: a call while the endpoint's last replay is still being sent answers 409. The endpoint must be enabled.

## Path parameters

- `id` string, required: The webhook endpoint's id (`wh_`).

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `since` string, date-time, required: From this moment, included.
  - `until` string, date-time: To this moment, excluded. Now when left out.
  - `status` 'failed' | 'all': failed (the default): only deliveries that did not arrive. all: delivered ones too.
  - `cursor` string: `nextCursor` from the call before, with the same range: continues after the last delivery it looked at.

## Response `200`

OK

- WebhookReplay
  - `queued` integer, required: Deliveries sent again now, one attempt each.
  - `skipped` integer, required: Deliveries this call looked at that the endpoint no longer takes (its types or profiles changed since): not sent again. Deliveries still waiting for a retry are never in a replay.
  - `more` boolean, required: True when the range holds more than this call sent: past its 1,000, or past the team's replays left this hour.
  - `nextCursor` string, nullable, required: With `more`: pass it as `cursor`, with the same range, to continue after the last delivery this call looked at, once this replay is done. Null otherwise.

## Other responses

- `400`: `invalid_request`: A field is missing or wrong, or the request cannot be done as asked: the message names the field or says what to change.
- `401`: `unauthorized`: No API key or sign-in, or the key does not work: it was deleted, or it expired.
- `403`: `forbidden`: The caller may not do this: the key or agent lacks the scope (the message names it), or the action needs another role or a fresh sign-in.
- `404`: `not_found`: No such object, or it is outside your team or the profiles your key reaches.
- `409`: `conflict`: The object's state does not allow it now, such as an account that needs a new login. `queue_empty`: A post with `queue: true` whose profile has no posting times: set them, or give a `scheduledAt`. `queue_full`: No posting time free for the post's accounts in the next 90 days: add times, or give a `scheduledAt`. `idempotency_key_in_use`: A request with this `Idempotency-Key` is still running: try again in a moment.
- `413`: `payload_too_large`: The body is over 1 MB: files go up through the upload links of `POST /v1/media`.
- `415`: `unsupported_media_type`: The body is not JSON: send it with `Content-Type: application/json`.
- `422`: `capability_missing`: The account cannot do this: see its `capabilities`. `idempotency_key_reused`: This `Idempotency-Key` was used for a different request in the last 24 hours: send a new key.
- `429`: `rate_limited`: Over one of Rizamo's limits, or a network asked Rizamo to slow down: wait for `Retry-After` seconds, or as long as the message says.
- `500`: `internal`: Our side failed: retry, and send the `requestId` if it keeps failing.
- `503`: `timeout`: The request took too long to work out, most often a report: try again in a moment, or ask a report for a shorter period or one profile.

---

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