Intake API

A FastAPI service that receives telemetry events, authenticates them against your Flare credentials, and enqueues them for async processing into ClickHouse.

Base URL

https://api.weflayr.com

Authentication

Every request requires a Bearer token matching your Flare’s client_secret.

Authorization: Bearer <your-client-secret>

Endpoint

POST /{client_id}/

Submit a telemetry event for the given client_id.

Path parameter

Parameter Type Description
client_id string (UUID) Your Flare client ID

Request body (JSON)

Field Type Required Description
event_id string (UUID) yes Groups .before, .after, .error for the same call
event_type string yes e.g. chat.completions.create.before
model string no LLM model identifier
tags object no Arbitrary key-value metadata
elapsed_ms number no Present on .after and .error events
other fields any no Provider-specific metrics, merged into the event

Response

{"ok": true}

Errors

Status Meaning
401 Missing, invalid, or mismatched credentials