HTTP API
TraceSpan
A single persisted OpenTelemetry span.
Shape: object
| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
id |
yes | string (uuid) |
The database identifier. Derived from the W3C identifiers. | — |
parentId |
no | string (uuid) |
The parent span’s database identifier. null for the root span. |
— |
spanId |
yes | string |
The W3C span identifier (16-character hex). | — |
name |
yes | string |
The span name. Example: chat gpt-5.4-mini, invoke_agent support. |
— |
kind |
no | TraceSpanKind |
The span kind. | — |
startedAt |
yes | string (date-time) |
The start time (UTC). | — |
endedAt |
no | string (date-time) |
The end time (UTC). | — |
status |
no | TraceSpanStatus |
The result status. | — |
attributes |
no | object |
The span attributes. GenAI semantic convention keys (gen_ai.request.model, gen_ai.usage.input_tokens) go here. |
— |