Sign inGet Started

bird webhooks callbacks replay

Usage

Esempio di codice
bird webhooks callbacks replay [flags]

Description

Replay failed callback deliveries

Queue redelivery of the workspace's failed SMS callback attempts in a window (default: the last 24 hours). An event is skipped only if one of its attempts inside the window was delivered, so the receiver must deduplicate on webhook-id. Each event goes to the URL its original attempts used. Nothing is returned beyond acceptance; each redelivery is one attempt, so check the outcome with the callback attempts list. Limited to 20 replays per organization per UTC day, shared with endpoint replays, and at most the oldest 10,000 events per replay.

Build the request from flags, a JSON WebhookReplayRequest body via --body-file ("-" reads stdin), or both — a flag overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

Examples

Esempio di codice
# print the body shape (no credentials needed)
bird webhooks callbacks replay --example

# the body it prints:
Esempio di codice
{
  "since": "2026-05-07T00:00:00Z",
  "until": "2026-05-07T23:59:59Z"
}

Options

Request

NameDescription
--body-fileRead the JSON request body from this file; "-" reads stdin
--examplePrint a complete example request body, then exit
--dry-runPrint the resolved request without sending it, then exit
--idempotency-keyDeduplication key; a retry with the same key won't act twice

Options

NameDescription
--sinceReplay events whose delivery attempt failed at or after this timestamp. The bound is inclusive and applies to attempt time, not to when the event occurred, so a retry that trailed its event by a day falls in the window by the hour it was attempted. Defaults to 24 hours before the request when omitted. Attempts are retained for three days, so that is the oldest history a replay reaches: an earlier since widens the window without recovering anything older.
--untilReplay events whose delivery attempt failed at or before this timestamp, on the same attempt-time bound as since. Omitted, it resolves to the time of the request.
--response-schemaPrint the fields this command returns, then exit
NameDescription
bird webhooks callbacks attemptsList callback delivery attempts
bird webhooks callbacks rotate-signing-secretRotate callback signing secret

Continua con la documentazione, le guide e gli esempi per questo argomento.