Skip to main content
POST
Add Spans

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

trace_id
string<uuid>
required

Body

application/json
Required array length: 1 - 500 elements
name
string
required
Required string length: 1 - 512
started_at
string<date-time>
required
span_id
string<uuid>
parent_span_id
string<uuid> | null
kind
enum<string>
default:OTHER

Categorises what a span represents in an agentic workflow.

Available options:
AGENT,
TOOL,
LLM,
RETRIEVER,
CHAIN,
EMBEDDING,
OTHER
status
enum<string>
default:UNSET

Mirrors the OTel StatusCode for a span's outcome.

Available options:
UNSET,
OK,
ERROR
input
unknown
output
unknown
model
string | null
Maximum string length: 255
token_usage
Token Usage · object | null
metadata
Metadata · object
ended_at
string<date-time> | null
error
string | null
completion_start_time
string<date-time> | null
model_parameters
Model Parameters · object | null
cost
Cost · object | null

Response

Successful Response

Response body for successfully added spans.

span_ids
string<uuid>[]
required