Skip to main content
POST
Replay events from the ledger to webhooks

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Body

application/json

Selects a ledger slice to re-deliver. Provide exactly one lower bound: since (an opaque cursor from GET /v1/events), sinceSeq (+inboxId, replay one partition from a seq), or sinceTimestamp (RFC3339).

since
string

Opaque keyset cursor (from GET /v1/events) to replay forward from.

sinceSeq
integer<int64>

Replay one partition starting at this seq (inclusive). Requires inboxId.

inboxId
string<uuid>

Scope the replay to one inbox partition (required with sinceSeq; an optional filter otherwise).

sinceTimestamp
string<date-time>

Replay events created at or after this RFC3339 timestamp.

until
string<date-time>

Optional upper bound (events created at or before this RFC3339 timestamp).

types
string[]

Optional event-type filter, e.g. ["email.bounced"].

webhookId
string

Optional: replay only to this one webhook subscription; otherwise to every matching active subscription.

maxEvents
integer
default:1000

Hard cap on the slice size. A slice that exceeds the cap is rejected with 400 asking the caller to page with until/maxEvents.

Required range: 1 <= x <= 5000

Response

Success

replayed
integer
required

Number of events re-delivered to at least one matching subscription.

skipped
integer
required

Number of events in the slice with no matching active subscription.

from
object | null
to
object | null