Ingestion API - Lumina Documentation

OTLP trace ingestion endpoint.

Endpoint

POST /v1/traces

Request Format

Accepts OTLP/JSON format:

{
  "resourceSpans": [{
    "resource": {
      "attributes": [{
        "key": "service.name",
        "value": { "stringValue": "my-service" }
      }]
    },
    "scopeSpans": [{
      "spans": [{
        "traceId": "...",
        "spanId": "...",
        "name": "llm_call",
        "attributes": [...]
      }]
    }]
  }]
}

Response

Success (200):

{
  "status": "ok",
  "tracesReceived": 1
}

Error (400):

{
  "error": "Invalid OTLP format",
  "details": "..."
}