# TraceSpan

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/schemas/tracespan/
> Summary: OpenAPI request or response schema for TraceSpan, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

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`](/http-api/schemas/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`](/http-api/schemas/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. | — |