Skip to main content
POST /v1/events is the main write. It is non-blocking: you get 202 after durable accept, FIFO sequence, and enqueue. Profile reads see the event after archive projection (processed). Idempotency-Key is required. Replays return the original result. A reused key with a different body returns 409.

Endpoints in this group

Batch accepts 1–100 events. Ordering is guaranteed per customer, not across customers. Statuses: accepted, processing, processed, failed, rejected. How to shape event_type, ontology_category, and object: events and intent ontology.