API documentation

The public API accepts authenticated event batches over HTTP/2. Access tokens are issued per workspace and can be scoped by source, region, and retention policy.

Endpoints

Method	Path	Purpose
POST	`/api/v2/batch`	Submit a signed event batch.
GET	`/api/v2/sources`	List active source definitions.
GET	`/api/v2/deliveries`	Inspect webhook delivery state.

Request shape

request body

{
  "source": "mobile-client",
  "batch_id": "evt_20260630_0001",
  "sent_at": "2026-06-30T12:00:00Z",
  "events": [
    {
      "type": "session.started",
      "id": "01J2R2M6W9Q8",
      "properties": {}
    }
  ]
}