Record a billing event (fact only)

POST 
/events

Accepts one event and writes it synchronously. Events are fact records only (e.g., outcomes) and do not carry pricing/cost semantics. Idempotency is server-side via request_hash (per billing account).

Request

Responses

200

Idempotent replay

201

Created

401

Unauthorized

403

Forbidden (realm/account mismatch, billing_account_id not derived from session/principal, or insufficient role)

409

Conflict (idempotency body mismatch or duplicate adjustment)

422

Unprocessable Entity (validation, visibility, or binding/meter unresolved)

429

Rate limited

Response Headers

Retry-After

Seconds to wait before retry.

503

Provider unavailable / transient failure