Ingest API

The ingest endpoint accepts newline-delimited JSON payloads over HTTPS and returns a 202 once the batch has been queued for processing. Requests are authenticated with a per-project bearer token issued from the dashboard.

POST /v3/ingest HTTP/1.1
Host: api.fernbach.dev
Authorization: Bearer fb_live_************************
Content-Type: application/x-ndjson

{"event":"session_start","ts":1725900000,"uid":"a1b2c3"}
{"event":"page_view","ts":1725900012,"path":"/pricing"}

Batches are capped at 5 MB and 10,000 events. Larger payloads should be split client-side; the SDKs handle this automatically with an internal queue and exponential backoff on 5xx responses.

{
  "accepted": 2,
  "rejected": 0,
  "batch_id": "b_9f2a7e1c"
}

See the rate limits page for per-plan throughput and the webhooks guide for delivery retries.