Ingest a batch of events (high-throughput)

Served by the high-load ingest service. Does NOT support dynamic meter creation or cost prediction — use POST /v1/events/ingest for those. Maximum 1000 events per call. Requires the METER_DATA.INGEST permission.

Authentication

X-API-KEYstring
API Key authentication via header
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

x-platform-idstringOptional
The platform ID.
x-api-keystringOptional
The API key used to authenticate the request.

Request

This endpoint expects an object.
eventslist of objectsRequired

Response

OK
eventslist of objects

Errors

401
Unauthorized Error
403
Forbidden Error