Skip to main content
DocumentationEvents

API reference

Events API

Publish an event, retrieve its immutable record, and inspect delivery history.

Arc Runtime 3.xUpdated Jul 18, 2026

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.

On this page
  1. Publish an event
  2. Response
  3. Idempotency