API reference
Events API
Publish an event, retrieve its immutable record, and inspect delivery history.
Publish an event
http
POST /v3/events HTTP/1.1
Content-Type: application/json
Idempotency-Key: order-ord_7K2M
{
"type": "order.accepted",
"payload": {
"orderId": "ord_7K2M",
"region": "north"
}
}Response
json
{
"id": "evt_2F9Q",
"type": "order.accepted",
"acceptedAt": "2026-07-18T10:32:08Z"
}Idempotency
Reuse the same idempotency key only when retrying the same logical publish operation. Keys are scoped to a workspace and retained for 24 hours.