Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Upload normalized JSON traces and queue background ingest jobs.
POST /api/ingest validates normalized JSON traces, stores the raw payload, queues an ingest job, and returns immediately.
The generated reference page for this flow is Queue trace ingestion.
POST /api/ingest accepts either:
POST /api/ingest
Authorization: Bearer <token>
Content-Type: application/json
{
"traces": [
{
"source": "codex_jsonl",
"sourceId": "session-123",
"model": "gpt-5",
"createdAt": "2026-06-04T12:00:00.000Z",
"messages": [
{
"position": 0,
"role": "user",
"content": "Build a trace uploader.",
"tokenCount": 6,
"createdAt": "2026-06-04T12:00:00.000Z"
}
]
}
]
}
{
"ok": true,
"jobId": "019e...",
"status": "queued"
}
202.