4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB
traces

Ingest spans from traces (v1 legacy)

Legacy trace-ingest endpoint. Accepts spans either as a raw JSON array or as an object with a data field containing the span array. Each span uses the same fields as Create a span, plus trace_unique_id, span_unique_id, and optional span_parent_id to build the trace tree. For new integrations, prefer Create a trace (OTLP).

post/api/v1/traces/ingest

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

OR

Response

Trace spans processed successfully

messagestring required

Human-readable ingest summary.