Sign in
Cloud Events

Get a cloud event

Returns one event including the decrypted payload and the routing decision summary.

get/v1/events/{eventId}

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/events/{eventId}
  • Auth: HTTP bearer

Path parameters

eventIdstring required

Event id.

Example:0c0afab1-7f6f-4f0b-9d8e-1e58e8b0f111

Cloud event id.

Response

Event detail.

dedupeKeystring required

Idempotency anchor.

eventTypestring nullable

Provider-specific event type.

idstring required

Stable UUID primary key.

matchedTaskCountinteger

Tasks the router matched.

occurredAtstring nullable

RFC3339 provider event time.

payloadobject

Decrypted normalized provider payload. Detail endpoint only.

receivedAtstring required

RFC3339 API receipt time.

routedAtstring nullable

RFC3339 router completion time.

routingobject

Routing decision summary (threshold, prompt versions, per-task decisions). Detail endpoint only.

routingStatus'pending' | 'routed' | 'skipped' | 'failed' required

Routing status.

source'gmail' | 'google_calendar' | 'google_drive' | 'slack' | 'webhook' | 'mcp' | 'github' | 'linear' | 'stripe' | 'internal' required

Event source.

sourceAccountIdstring nullable

Connected-account key.

sourceEventIdstring nullable

Provider-side event id.

subjectstring nullable

Short title.

textstring nullable

Human-readable gist.

Example response

{
  "dedupeKey": "gmail:msg:msg_123",
  "eventType": "email.received",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "matchedTaskCount": 1,
  "occurredAt": "2026-06-06T14:00:00Z",
  "receivedAt": "2026-06-06T14:00:02Z",
  "routedAt": "2026-06-06T14:00:09Z",
  "routingStatus": "routed",
  "source": "gmail",
  "sourceAccountId": "acct_google_primary",
  "sourceEventId": "evt_123",
  "subject": "Invoice #4821 dispute",
  "text": "Acme disputed invoice #4821."
}

Changes

No operation changes recorded.