Skip to main content

Accepts a recorded delivery event into the workspace's relay buffer.

POST 
/v1/relay/events

This is the event-posting path the platform's delivery pipeline writes to: the worker posts each recorded delivery-ledger row here, and a connected tunnel for the same workspace receives it. The hop is internal and authenticated by the shared X-Nervly-Relay-Secret header, not a workspace API key — the caller is the platform, not a tenant. The workspace_id in the body is therefore trusted from the authenticated pipeline, and the buffer is keyed by it.

Idempotent on delivery_id: a pipeline retry after an ambiguous response does not enqueue a second copy.

Request​

Responses​

Event durably buffered for the workspace's tunnel.