> ## Documentation Index
> Fetch the complete documentation index at: https://docs.belvedir.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /api/v1/traces — Ingest OpenTelemetry Spans

> Send OpenTelemetry trace data to Fractal in OTLP JSON format. This endpoint powers the trace analysis dashboard and is called automatically by the SDK.

Receives OpenTelemetry trace data in OTLP JSON format. This is called automatically by the SDK.

* **Authorization** — Bearer token with your API key, or use the `x-api-key` header.
* **Body** — OTLP JSON with a `resourceSpans` array.

Traces tagged with a session id from `withSession` are grouped into sessions and segmented into tasks; untagged spans still land but can't be linked or segmented.