Ingest events
Ingest usage events for metering and billing purposes.
Events are deduplicated by (event_id, customer_id) — re-sending the same pair will not be
double-counted. If timestamps differ across duplicates, the event with the latest timestamp is used.
By default, any invalid event rejects the entire batch. Set allow_partial_failures to true to ingest valid events and receive per-event failure details in the response body.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
1–100 events per request.
Allow events with timestamps more than 1 day in the past. Defaults to false.
Accept the batch even if some events fail validation. Defaults to false.
When true, valid events are ingested and failures are reported in the response body.
When false (default), any invalid event rejects the entire batch.
Response
Events ingested successfully
Events that failed to ingest. Omitted when no failures.