Ingest spans (legacy)

Accepts spans as a JSON array or an object whose data field contains the array. Each span uses the fields in Create a span, plus trace_unique_id, span_unique_id, and optional span_parent_id to build the trace tree. For new integrations, use Ingest traces (OTLP).

Authentication

AuthorizationBearer

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

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

403

Forbidden Error

500

Internal Server Error