OTLP/HTTP ingest endpoint (OTel GenAI semconv v1.29.0)

Accepts an OpenTelemetry ExportTraceServiceRequest payload, either as protobuf (application/x-protobuf) or JSON (application/json). Maps OTel GenAI semantic convention attributes onto TruLayer’s span model and routes each span through the standard ingestion pipeline (Kafka → processor → TimescaleDB).

Point your OTel Collector’s otlphttp exporter at this URL to dual-ship traces to TruLayer without a second SDK.

POST /v1/otlp/traces

OTLP/HTTP ingest endpoint (OTel GenAI semconv v1.29.0)

cURL

curl --request POST \
  --url https://api.trulayer.ai/v1/otlp/traces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-protobuf' \
  --data '"<string>"'

200

"<string>"

Authorizations

Authorization · string · header · required

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

Body

application/x-protobufapplication/json

The body is of type file.

Response

200

application/x-protobuf

OTLP ExportTraceServiceResponse. partial_success is populated iff one or more spans failed to persist.

The response is of type file.