Skip to main content
POST
Ingest OTLP traces

Authorizations

X-API-Key
string
header
required

Organization API key for authentication

Headers

X-Simulation-Id
string

Simulation output ID to associate the spans with. Use for simulation-based flows. Mutually exclusive with X-Conversation-Id.

X-Conversation-Id
string

Conversation (Run) ID returned by POST /v1/conversations:submit. Use for monitoring flows. Mutually exclusive with X-Simulation-Id.

Body

OTLP ExportTraceServiceRequest payload — protobuf or JSON.

OTLP/HTTP protobuf-encoded ExportTraceServiceRequest. This is the default content type emitted by the OpenTelemetry HTTP exporter (opentelemetry-exporter-otlp-proto-http).

Response

Spans accepted and queued for ingestion.

status
string
required

Always ok on success.

Example:

"ok"

simulation_output_id
string
required

The simulation output ID the spans were associated with. For monitoring flows submitted via X-Conversation-Id, this equals the conversation ID.

Example:

"a1b2c3d4"