For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • POSTList traces
      • POSTBulk delete traces
      • GETRetrieve a trace
      • DELDelete a trace
      • PATCHShare a trace publicly
      • GETRetrieve a public trace
      • POSTIngest spans from traces (v1 legacy)
      • POSTCreate a trace (OTLP)
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceTraces

Ingest spans from traces (v1 legacy)

POST
https://api.respan.ai/api/v1/traces/ingest
POST
/api/v1/traces/ingest
$curl -X POST https://api.respan.ai/api/v1/traces/ingest \
>     -H "Authorization: Bearer sk_live_xxxxx" \
>     -H "Content-Type: application/json" \
>     -d '[
>  {
>    "trace_unique_id": "trace_abc123",
>    "span_unique_id": "span_001"
>  }
>]'
1{
2  "message": "Processed 2 Vercel spans"
3}
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).
Was this page helpful?
Previous

Create a trace (OTLP)

Next
Built with

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

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Request

This endpoint expects a list of objects or an object.
list of objectsRequired
Array of span objects to ingest as traces.
OR
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