The centralized log of domain events across every domain, as CloudEvents 1.0 envelopes. Supports REST polling and a live stream, and keeps a permanent audit history whether or not a message broker is in use.

Publishing records an event a domain producer emits. It is for systems recording what happened, not for requests made on a person's behalf.

Base URL: https://api.example.com/platform

Events

Centralized event log across all domains.

▶ GET /events List events

Queryable log of all domain events across the blueprint. Supports REST polling as an integration pattern and provides permanent audit history regardless of whether a message broker is in use.

Events are returned in ascending time order (oldest first) to support cursor-based polling.

Parameters
Name Type In Req Description
▶q string query Search query using field:value syntax. Multiple conditions separated by
▶sort string query Comma-separated list of fields to sort the response by. Prefix a field
▶type string query Filter by CloudEvents type. Supports prefix matching with a trailing wildcard (e
▶source string query Filter by CloudEvents source (the domain that produced the event, e.g., `/intake
▶subject string query Filter by CloudEvents subject — the entity ID the event pertains to. Because eve
traceid string query

Filter by W3C Trace Context trace ID extracted from the traceparent attribute. All events sharing a trace ID were causally triggered by the same root action.

causationid string query

Filter by the causationid extension — the ID of the event that directly caused this one. Use it to find the response event(s) produced by a specific trigger (e.g., the call.completed fired for one service_call.created when several were emitted for the same subject).

start string query

Return only events at or after this timestamp (ISO 8601).

end string query

Return only events before or at this timestamp (ISO 8601).

limit integer query

Maximum number of items to return (1-100).

offset integer query

Number of items to skip before collecting results.

Responses
200 Paginated list of CloudEvents envelopes, ordered by time ascending.
▶ EventList
total integer required Total number of items available.
limit integer required Maximum number of items requested.
offset integer required Number of items skipped before the current page.
hasNext boolean Whether more items are available beyond the current page.
▶ items array[Event] required
type string required Fully qualified CloudEvents event type, {domain}.{resource}.{event} (e.g., intake.application.submitted): the domain as declared, the resource's schema name in snake_case.
description string Human-readable annotation for state machine authors. Not a CloudEvents field.
subject string CloudEvents subject override. The entity ID the event pertains to. Defaults to the emitting resource's own id when omitted.
causationid string CloudEvents Correlation extension (optional). Value expression resolving to the id of the event that directly caused this one. Use when an event is emitted in response to another event (e.g., auto-resume triggered by a timer callback).
data object Event-specific payload. Field values are value expressions resolved at emit time.
specversion string required CloudEvents specification version.
id string (uuid) required Unique event identifier.
source string required Domain base path that produced the event (e.g., /intake, /workflow).
subject string (uuid) required Entity ID the event pertains to.
time string (date-time) required When the event occurred.
datacontenttype string required Media type of the event payload.
traceparent string W3C Trace Context header (optional). Propagated from the triggering request or event. The trace ID component is stable across the full causal chain.
causationid string (uuid) CloudEvents Correlation extension (optional). The `id` of the event that directly caused this one. Use when an event is emitted in direct response to another event (e.g., a task auto-resumed because a timer fired). Allows consumers to trace the immediate cause without inspecting the full distributed trace.
partitionkey string CloudEvents Partitioning extension (optional). Groups events that must be handled in order: a subscriber handles events with the same partitionkey one at a time, in the order they occurred. The producer chooses the key — typically the id of the record that owns the others, so everything about one application stays in order.
authid string CloudEvents Auth Context extension (optional). Principal identifier (userId from JWT claims) of the actor who triggered the event. No PII — user ID only, not name or email. Required for FTI-governed events per IRS Pub. 1075. Omitted when no caller identity is present.
authtype string CloudEvents Auth Context extension (optional). Principal type of the actor who triggered the event. Required when authid is present. Required for FTI-governed events per IRS Pub. 1075.
enumuser service_account api_key system unauthenticated unknown null
data object Event-specific payload. Schema is defined per event type in each domain's AsyncAPI file.
400 The request is malformed or contains invalid parameters.
▶ BadRequest
code string required Machine-readable error code.
message string required Human-readable error description.
details array[object] Additional error details.
500 An unexpected error occurred on the server.
▶ InternalError
code string required Machine-readable error code.
message string required Human-readable error description.
details array[object] Additional error details.
▶ POST /events Publish an event

Publish a CloudEvents 1.0 envelope to the event log. Used by domain producers to record state transitions and significant data mutations.

Request body required
▶ Event
type string required Fully qualified CloudEvents event type, {domain}.{resource}.{event} (e.g., intake.application.submitted): the domain as declared, the resource's schema name in snake_case.
description string Human-readable annotation for state machine authors. Not a CloudEvents field.
subject string CloudEvents subject override. The entity ID the event pertains to. Defaults to the emitting resource's own id when omitted.
causationid string CloudEvents Correlation extension (optional). Value expression resolving to the id of the event that directly caused this one. Use when an event is emitted in response to another event (e.g., auto-resume triggered by a timer callback).
data object Event-specific payload. Field values are value expressions resolved at emit time.
specversion string required CloudEvents specification version.
id string (uuid) required Unique event identifier.
source string required Domain base path that produced the event (e.g., /intake, /workflow).
subject string (uuid) required Entity ID the event pertains to.
time string (date-time) required When the event occurred.
datacontenttype string required Media type of the event payload.
traceparent string W3C Trace Context header (optional). Propagated from the triggering request or event. The trace ID component is stable across the full causal chain.
causationid string (uuid) CloudEvents Correlation extension (optional). The `id` of the event that directly caused this one. Use when an event is emitted in direct response to another event (e.g., a task auto-resumed because a timer fired). Allows consumers to trace the immediate cause without inspecting the full distributed trace.
partitionkey string CloudEvents Partitioning extension (optional). Groups events that must be handled in order: a subscriber handles events with the same partitionkey one at a time, in the order they occurred. The producer chooses the key — typically the id of the record that owns the others, so everything about one application stays in order.
authid string CloudEvents Auth Context extension (optional). Principal identifier (userId from JWT claims) of the actor who triggered the event. No PII — user ID only, not name or email. Required for FTI-governed events per IRS Pub. 1075. Omitted when no caller identity is present.
authtype string CloudEvents Auth Context extension (optional). Principal type of the actor who triggered the event. Required when authid is present. Required for FTI-governed events per IRS Pub. 1075.
enumuser service_account api_key system unauthenticated unknown null
data object Event-specific payload. Schema is defined per event type in each domain's AsyncAPI file.
Responses
201 Event published successfully.
▶ Event
type string required Fully qualified CloudEvents event type, {domain}.{resource}.{event} (e.g., intake.application.submitted): the domain as declared, the resource's schema name in snake_case.
description string Human-readable annotation for state machine authors. Not a CloudEvents field.
subject string CloudEvents subject override. The entity ID the event pertains to. Defaults to the emitting resource's own id when omitted.
causationid string CloudEvents Correlation extension (optional). Value expression resolving to the id of the event that directly caused this one. Use when an event is emitted in response to another event (e.g., auto-resume triggered by a timer callback).
data object Event-specific payload. Field values are value expressions resolved at emit time.
specversion string required CloudEvents specification version.
id string (uuid) required Unique event identifier.
source string required Domain base path that produced the event (e.g., /intake, /workflow).
subject string (uuid) required Entity ID the event pertains to.
time string (date-time) required When the event occurred.
datacontenttype string required Media type of the event payload.
traceparent string W3C Trace Context header (optional). Propagated from the triggering request or event. The trace ID component is stable across the full causal chain.
causationid string (uuid) CloudEvents Correlation extension (optional). The `id` of the event that directly caused this one. Use when an event is emitted in direct response to another event (e.g., a task auto-resumed because a timer fired). Allows consumers to trace the immediate cause without inspecting the full distributed trace.
partitionkey string CloudEvents Partitioning extension (optional). Groups events that must be handled in order: a subscriber handles events with the same partitionkey one at a time, in the order they occurred. The producer chooses the key — typically the id of the record that owns the others, so everything about one application stays in order.
authid string CloudEvents Auth Context extension (optional). Principal identifier (userId from JWT claims) of the actor who triggered the event. No PII — user ID only, not name or email. Required for FTI-governed events per IRS Pub. 1075. Omitted when no caller identity is present.
authtype string CloudEvents Auth Context extension (optional). Principal type of the actor who triggered the event. Required when authid is present. Required for FTI-governed events per IRS Pub. 1075.
enumuser service_account api_key system unauthenticated unknown null
data object Event-specific payload. Schema is defined per event type in each domain's AsyncAPI file.
400 The request is malformed or contains invalid parameters.
▶ BadRequest
code string required Machine-readable error code.
message string required Human-readable error description.
details array[object] Additional error details.
422 The request was well-formed but contained semantic errors.
▶ UnprocessableEntity
code string required Machine-readable error code.
message string required Human-readable error description.
details array[object] Additional error details.
500 An unexpected error occurred on the server.
▶ InternalError
code string required Machine-readable error code.
message string required Human-readable error description.
details array[object] Additional error details.
▶ GET /events/stream Stream domain events (SSE)

Real-time stream of domain events delivered as Server-Sent Events (SSE).

Connect with Accept: text/event-stream. Each event is one SSE message: an id: line with the event's id, and a data: line with the JSON-encoded Event.

To pick up after a dropped connection, reconnect with the last id received in Last-Event-ID, as a browser's EventSource does on its own: the stream first sends every matching event after that one, in the order they happened, then carries on live. An id the log no longer has is answered 410 Gone, so a reader never quietly misses events; it reads what it needs afresh and connects again without one.

The filters are the ones listing events takes.

A server that can't hold a connection open — behind an API gateway that ends requests early, say — may leave the stream out and answer 501. Readers then poll listing events, with the same filters and start, which every server serves.

The stream stays open until the client disconnects. A : heartbeat comment is sent every 30 seconds to prevent proxy timeouts.

Parameters
Name Type In Req Description
▶type string query Filter by CloudEvents type. Supports prefix matching with a trailing wildcard (e
▶source string query Filter by CloudEvents source (the domain that produced the event, e.g., `/intake
▶subject string query Filter by CloudEvents subject — the entity ID the event pertains to. Because eve
Last-Event-ID string header

The id of the last event received, when reconnecting. Events after it are sent first.

Responses
200 SSE stream of domain events.
type string required Fully qualified CloudEvents event type, {domain}.{resource}.{event} (e.g., intake.application.submitted): the domain as declared, the resource's schema name in snake_case.
description string Human-readable annotation for state machine authors. Not a CloudEvents field.
subject string CloudEvents subject override. The entity ID the event pertains to. Defaults to the emitting resource's own id when omitted.
causationid string CloudEvents Correlation extension (optional). Value expression resolving to the id of the event that directly caused this one. Use when an event is emitted in response to another event (e.g., auto-resume triggered by a timer callback).
data object Event-specific payload. Field values are value expressions resolved at emit time.
specversion string required CloudEvents specification version.
id string (uuid) required Unique event identifier.
source string required Domain base path that produced the event (e.g., /intake, /workflow).
subject string (uuid) required Entity ID the event pertains to.
time string (date-time) required When the event occurred.
datacontenttype string required Media type of the event payload.
traceparent string W3C Trace Context header (optional). Propagated from the triggering request or event. The trace ID component is stable across the full causal chain.
causationid string (uuid) CloudEvents Correlation extension (optional). The `id` of the event that directly caused this one. Use when an event is emitted in direct response to another event (e.g., a task auto-resumed because a timer fired). Allows consumers to trace the immediate cause without inspecting the full distributed trace.
partitionkey string CloudEvents Partitioning extension (optional). Groups events that must be handled in order: a subscriber handles events with the same partitionkey one at a time, in the order they occurred. The producer chooses the key — typically the id of the record that owns the others, so everything about one application stays in order.
authid string CloudEvents Auth Context extension (optional). Principal identifier (userId from JWT claims) of the actor who triggered the event. No PII — user ID only, not name or email. Required for FTI-governed events per IRS Pub. 1075. Omitted when no caller identity is present.
authtype string CloudEvents Auth Context extension (optional). Principal type of the actor who triggered the event. Required when authid is present. Required for FTI-governed events per IRS Pub. 1075.
enumuser service_account api_key system unauthenticated unknown null
data object Event-specific payload. Schema is defined per event type in each domain's AsyncAPI file.
410 The log no longer has the event Last-Event-ID names, so the events after it can't be sent.
code string required Machine-readable error code.
message string required Human-readable error description.
details array[object] Additional error details.
501 This server doesn't stream events; poll listing events instead.
code string required Machine-readable error code.
message string required Human-readable error description.
details array[object] Additional error details.
▶ GET /events/{eventId} Get a domain event

Retrieve a single domain event by its identifier.

Parameters
Name Type In Req Description
eventId string path ✓

Unique identifier of the domain event.

Responses
200 Domain event retrieved successfully.
▶ Event
type string required Fully qualified CloudEvents event type, {domain}.{resource}.{event} (e.g., intake.application.submitted): the domain as declared, the resource's schema name in snake_case.
description string Human-readable annotation for state machine authors. Not a CloudEvents field.
subject string CloudEvents subject override. The entity ID the event pertains to. Defaults to the emitting resource's own id when omitted.
causationid string CloudEvents Correlation extension (optional). Value expression resolving to the id of the event that directly caused this one. Use when an event is emitted in response to another event (e.g., auto-resume triggered by a timer callback).
data object Event-specific payload. Field values are value expressions resolved at emit time.
specversion string required CloudEvents specification version.
id string (uuid) required Unique event identifier.
source string required Domain base path that produced the event (e.g., /intake, /workflow).
subject string (uuid) required Entity ID the event pertains to.
time string (date-time) required When the event occurred.
datacontenttype string required Media type of the event payload.
traceparent string W3C Trace Context header (optional). Propagated from the triggering request or event. The trace ID component is stable across the full causal chain.
causationid string (uuid) CloudEvents Correlation extension (optional). The `id` of the event that directly caused this one. Use when an event is emitted in direct response to another event (e.g., a task auto-resumed because a timer fired). Allows consumers to trace the immediate cause without inspecting the full distributed trace.
partitionkey string CloudEvents Partitioning extension (optional). Groups events that must be handled in order: a subscriber handles events with the same partitionkey one at a time, in the order they occurred. The producer chooses the key — typically the id of the record that owns the others, so everything about one application stays in order.
authid string CloudEvents Auth Context extension (optional). Principal identifier (userId from JWT claims) of the actor who triggered the event. No PII — user ID only, not name or email. Required for FTI-governed events per IRS Pub. 1075. Omitted when no caller identity is present.
authtype string CloudEvents Auth Context extension (optional). Principal type of the actor who triggered the event. Required when authid is present. Required for FTI-governed events per IRS Pub. 1075.
enumuser service_account api_key system unauthenticated unknown null
data object Event-specific payload. Schema is defined per event type in each domain's AsyncAPI file.
404 The requested resource was not found.
▶ NotFound
code string required Machine-readable error code.
message string required Human-readable error description.
details array[object] Additional error details.
500 An unexpected error occurred on the server.
▶ InternalError
code string required Machine-readable error code.
message string required Human-readable error description.
details array[object] Additional error details.