# RunTrace

> 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/runtrace/
> Summary: OpenAPI request or response schema for RunTrace, including required fields, defaults, constraints, and linked nested types.

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

A run's span tree. The waterfall view is built on top of this.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `id` | yes | `string (uuid)` | The database identifier. | — |
| `traceId` | yes | `string` | The W3C trace identifier (32-character hex). | — |
| `runId` | no | `string (uuid)` | The associated run. `null` for spans without a run. | — |
| `tenantId` | yes | `string` | The tenant identifier. | — |
| `startedAt` | yes | `string (date-time)` | The first span's start (UTC). | — |
| `endedAt` | no | `string (date-time)` | The last span's end (UTC). | — |
| `spans` | no | array of [`TraceSpan`](/http-api/schemas/tracespan/) | The spans, ordered by start time. | — |