v52

latestOpenAPI 3.0.1AGPL-3.0raw.githubusercontent.com2026-08-01255473862.7 KB
Events

Bulk ingest events

Use when batching usage events (e.g. backfill or high-volume ingestion). More efficient than single event calls; returns 202 when accepted.

post/events/bulk

Request body

Example request

{
  "events": [
    {
      "customer_id": "customer456",
      "event_id": "event123",
      "event_name": "api_request",
      "external_customer_id": "customer456",
      "properties": {
        "\"response_status\"": "200}",
        "{\"request_size\"": "100"
      },
      "source": "api",
      "timestamp": "2024-03-20T15:04:05Z"
    }
  ]
}

Response

message:Event accepted for processing

object required