v1

latestOpenAPI 3.1.02026-07-2342714.6 KB

Ingest a single CloudEvent

Accepts one CloudEvent, validates its schema, and enqueues it for durable publication to Kafka.

Returns 202 Accepted the moment the event lands in the in-process queue — Kafka and Postgres latency are fully hidden from the caller. Delivery from there is at-least-once with idempotent inserts on (id, occurred_at), so replays after a crash never produce duplicate rows in the audit store.

post/v1/auditmanager/events

Request body

specversion'1.0'

idstring

sourcestring required

typestring required

subjectstring nullable

timestring date-time

datacontenttypestring

traceparentstring nullable

Response

Event accepted into the ingest queue. The id you submitted is echoed back.

idstring

Constant — identifies the service that produced this envelope.

versionstring

Envelope schema version (not the service version).

responsetimestring required

RFC3339 timestamp at which this response was produced.