Webhooks / API reference
Queue another delivery attempt for an existing customer event
Request and response reference for POST /v1/webhook-deliveries/{event_id}/replay.
POST
/v1/webhook-deliveries/{event_id}/replayAuthentication: API key
Use the base URL and access configuration provided to your institution. Examples are request templates, not transaction results. Field tables focus on client fields; preserve additional metadata returned by the configured service.
Request
Keep API keys in your backend. Required entitlements and institution scope still apply.
curl -X POST "$OSAI_API_BASE_URL/v1/webhook-deliveries/$EVENT_ID/replay" \
-H "Authorization: ApiKey $OSAI_PUBLIC_ID:$OSAI_API_SECRET" \
-H "Idempotency-Key: <stable-operation-key>"Parameters
| Name | Location | Requirement | Description |
|---|---|---|---|
Authorization | header · string | Required | Use the value defined for this resource. |
X-Request-Id | header · string | Optional | Use the value defined for this resource. |
Idempotency-Key | header · string | Required | Use the value defined for this resource. |
event_id | path · string | Required | Use the value defined for this resource. |
Request body
This operation does not define a JSON request body.
Responses
Inspect HTTP status before parsing a body. These tables describe client response fields rather than invented successful transaction payloads.
202 · Replay queued with the same stable event ID
| Field | Type | Description & constraints |
|---|---|---|
event_idRequired in parent object | string | Defined by the resource contract. |
statusRequired in parent object | string | Defined by the resource contract.Values: QUEUED |
request_idRequired in parent object | string | Defined by the resource contract. |
403 · The institution is not entitled to replay webhooks
No client body fields are defined for this response.
404 · Resource not found
| Field | Type | Description & constraints |
|---|---|---|
errorRequired in parent object | object | Defined by the resource contract. |
error.codeRequired in parent object | string | Defined by the resource contract. |
error.messageRequired in parent object | string | Defined by the resource contract. |
error.request_idRequired in parent object | string | Defined by the resource contract. |
409 · Event is not eligible for replay or idempotency conflict
No client body fields are defined for this response.
Retries & recovery
Keep the original request identifiers and any required idempotency key. A timeout does not establish failure. Read the original resource or command before another financial write; use expected versions for concurrent changes.