Skip to main content
POST
Ingest a single trace

Authorizations

Authorization
string
header
required

SDK API key (tl_...) or Clerk session JWT

Body

application/json
id
string
external_id
string | null
name
string | null
input
string | null
output
string | null
model
string | null
latency_ms
integer | null
cost
number | null
error
string | null
tags
object

User-defined key→value tags for the trace. Maximum 20 keys; keys and values are strings up to 64 characters each. Queryable via the tag_key / tag_value query parameters on GET /v1/traces. Omit or send an empty object when unused.

metadata
object
spans
object[]
events
object[]

Response

Duplicate — already ingested (idempotent)

status
string
required
Example:

"duplicate"