webhooks

Replay failed deliveries since a time

After your endpoint was down, queue a fresh attempt for every delivery of this subscription that failed for good since a time.

since is an ISO 8601 time, at most 7 days ago. Deliveries that failed for good (status=failed) created at or after it are replayed, oldest first.

At most 100 replays per call; remaining counts the rest, so call again until it is 0. more: true means more failed deliveries exist than one call reads: move since forward past the last one replayed and call again, since the same since re-reads the same oldest deliveries.

A delivery that already has a replay is skipped, so calling again never sends one event twice; so is one whose payload was removed (90-day retention or a contact's erasure). Concurrent bulk replays of this webhook are refused with 409 conflict and Retry-After: 60 while its replay lock is held. Retry after the first finishes; it skips the deliveries already replayed. If the lock service is unavailable, the call answers 503 service_unavailable. Local development without Redis skips the lock and logs a warning.

Each replay is sent to the subscription's current URL and signed with its current secret, with replay=true and replay_of=<original delivery id> in the payload.

The subscription must exist and be active. Limited to 10 calls an hour per workspace, shared with the dashboard. Send Idempotency-Key so a network retry replays the first answer.

post/api/v1/webhooks/{id}/replay-failed

Request

  • Base URL: https://app.blueticked.com
  • URL: https://app.blueticked.com/api/v1/webhooks/{id}/replay-failed
  • Auth: HTTP bearer

Path parameters

idstring required

The resource's unique identifier.

Headers

Idempotency-Keystring

A unique key (e.g. a UUID) that makes a POST safe to retry: replaying the same key within 24h returns the original result instead of acting twice.

Request body

sincestring

Example request

{
  "since": "2026-08-04T08:00:00.000Z"
}

Response

Success

replayednumber required
queuednumber required
remainingnumber required
moreboolean required
delivery_idsstring[] required
request_idstring required

Example response

{
  "replayed": 2,
  "queued": 2,
  "skipped": {
    "already_replayed": 1
  },
  "delivery_ids": [
    "d49ba6e2-574d-4a83-addb-be039dc32170"
  ],
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}

Changes

No recorded changes to this operation across all 1 revision of this API.