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).

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](/docs/apis/spans/api-request-logs), 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)](/docs/apis/traces/create-trace).

Request

This endpoint expects a list of objects or an object.

list of objectsRequired

Array of span objects to ingest as traces.

objectRequired

Wrapper object accepted by the legacy integration endpoint.

Response

Trace spans processed successfully

messagestring

Human-readable ingest summary.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

1	curl -X POST https://api.respan.ai/api/v1/traces/ingest \
2	-H "Authorization: Bearer sk_live_xxxxx" \
3	-H "Content-Type: application/json" \
4	-d '[
5	{
6	"trace_unique_id": "trace_abc123",
7	"span_unique_id": "span_001"
8	}
9	]'

Headers

Request

Response

Errors