Delivery API
Inspect receiver admission and retry outcomes, then replay retained events under the active grant.
Inspect receiver admission and retry outcomes, then replay retained events under the active grant.
Use the shared request contract for authentication, pagination, preconditions, idempotency, and common errors. Exact response members are defined in API data types and the downloadable OpenAPI contract.
List deliveries
/api/v1/connector/organizations/{organization_id}/subscriptions/{subscription_id}/deliveriesLists delivery states, stable event IDs, and attempt outcomes.
limitintegeroptionalNumber of records; bounds are inclusive.
50rule1–200cursorstringoptionalOpaque continuation; preserve the original filters.
event_idstringoptionalFilter one stable event identity.
statestringoptionalFilter one state.
Returns a data array of Delivery records, pagination.next_cursor, and request_id.
Read a delivery
/api/v1/connector/organizations/{organization_id}/subscriptions/{subscription_id}/deliveries/{delivery_id}Returns attempts and the last HTTP or transport result.
delivered means the receiver acknowledged receipt. It does not mean a ticket, deployment, or native response completed.
Returns data as Delivery, plus request_id.
Replay a delivery
/api/v1/connector/organizations/{organization_id}/subscriptions/{subscription_id}/deliveries/{delivery_id}/replayStarts a delivery window for the same event under present authorization.
Requires Idempotency-Key.
Requires an enabled subscription and active connection. A paused or revoked path returns 409 connection_inactive; an expired event returns 410 event_expired. Replays use a fresh timestamp and active signing version. Unchanged event identity requires receiver deduplication. Replay is not a way to restore removed grants.
reasonstringrequiredAudited reason; empty values are rejected.
Returns operation.id for operation polling and request_id; acceptance does not establish completion.