List events

Read accepted workspace events in cursor order.

GET /events/stream

List events

cURL

curl --request GET \
  --url https://useorgx.com/api/v1/events/stream \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "a5614527-0ce6-43be-8d1d-d012b7394867",
      "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89",
      "ownerId": "5902c040-0e2f-4a76-8f7f-00fa275b2940",
      "aggregateType": "work",
      "aggregateId": "7fbb727d-17c4-4bc7-9fc7-60eb15e9314d",
      "aggregateVersion": 1,
      "eventType": "work",
      "schemaVersion": 1,
      "actorType": "work",
      "actorId": "launch-review-agent",
      "payload": {},
      "payloadDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "occurredAtCanonical": "2026-08-18T18:30:00.000Z",
      "idempotencyKey": "launch-plan-review",
      "causationId": "eb590f00-d27a-4184-8332-47747f78f3e4",
      "correlationId": "c54dbab4-488d-487f-85da-d041381e34cb",
      "contextManifestDigest": "context_manifest_digest",
      "previousHash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "eventHash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  ],
  "meta": {}
}

Authorizations

bearerAuthcookieAuth

Authorization · string · header · required

OrgX API key, sent as Authorization: Bearer oxk_...

Headers

Last-Event-ID · string

Opaque cursor returned in the previous SSE event id field.

Query Parameters

workspace_id · string<uuid> · required

cursor · string

Opaque cursor returned as meta.nextCursor.

limit · integer · default: 50

Required range: 1 <= x <= 100

event_type · string[]

Repeat to filter accepted events by ledger event type.

aggregate_type · string

Pattern: ^[a-z][a-z0-9_.-]{0,99}$

transport · enum<string> · default: json

Use sse for a bounded Server-Sent Events lease.

Available options: json, sse

after · string

Opaque SSE replay cursor. Equivalent to Last-Event-ID.

stream_ms · integer · default: 60000

Maximum SSE lease duration in milliseconds.

Required range: 1 <= x <= 300000

poll_ms · integer · default: 1000

Ledger polling interval for the SSE lease in milliseconds.

Required range: 1 <= x <= 10000

Response

200

application/json

Replayable ledger event page or bounded SSE lease

data · object[] · required

Show child attributes

meta · object · required

Show child attributes