Ingest
Ingest a batch of traces
Validates the payload, resolves the API key, prices each span, and buffers the rows for a flush to ClickHouse. Fire-and-forget: a 202 means the batch was accepted, not yet durably written.
post/ingest
Request body
Example request
{
"version": "v1",
"traces": [
{
"traceId": "0192f1c0-1a2b-7c3d-8e4f-1a2b3c4d5e6f",
"traceName": "classify-email",
"agentName": "summarizer",
"workflowName": "deploy-digest",
"workflowRunId": "run_2024_05_24",
"sessionId": "session_abc123",
"customer": {
"id": "cus_acme",
"name": "Acme Inc",
"imageUrl": "https://logo.clearbit.com/acme.com"
},
"metadata": {
"environment": "production",
"region": "us-east-1"
},
"spans": [
{
"spanId": "span_1",
"parentSpanId": "span_0",
"spanType": "llm",
"name": "generateText",
"startTime": 1716566400000,
"endTime": 1716566401200,
"status": "ok",
"provider": "openai",
"modelId": "gpt-4o",
"usage": {
"inputTokens": 1200,
"outputTokens": 350,
"totalTokens": 1550
},
"ttftMs": 320,
"metadata": {
"environment": "production",
"region": "us-east-1"
}
}
]
}
]
}Response
Batch accepted into the write buffer.
Example response
{
"accepted": 3
}