Record a batch of billing events
POST/events/batch
Appends up to 1000 Billing system events. Idempotency-Key identifies the HTTP request while each item carries its own user-scoped event_key. Item-level first-write deduplication and validation failures are reported in the 207 response.
Request
Responses
- 207
- 401
- 403
- 429
- 500
Multi-Status (per-item results)
Unauthorized
Forbidden (realm/account mismatch, billing account not derived from your session/principal, or insufficient role)
Rate limited
Response Headers
Retry-After
Seconds to wait before retry.
Internal Server Error