# WorkflowCheckpointRecord

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

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

Represents a single checkpoint of a workflow run.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `id` | yes | `string (uuid)` | Gets the record identifier. A time-ordered UUID (v7). | — |
| `tenantId` | yes | `string` | Gets the tenant the record belongs to. | — |
| `sessionId` | yes | `string` | Gets the identifier of the run session. Microsoft Agent Framework groups checkpoints under this value. | — |
| `checkpointId` | yes | `string` | Gets the checkpoint identifier. The value belongs to Tracon, not to Microsoft Agent Framework: `CreateAsync` generates it and hands it back to MAF. | — |
| `parentCheckpointId` | no | `string` | Gets the identifier of the previous checkpoint. `null` for the first checkpoint. | — |
| `runId` | no | `string (uuid)` | Gets the identifier of the run that produced this checkpoint. `null` if no run was in progress when the checkpoint was written. | — |
| `createdAt` | yes | `string (date-time)` | Gets the creation time (UTC). | — |
| `state` | yes | [`JsonElement`](/http-api/schemas/jsonelement/) | Gets the opaque run state. | — |
| `stateSchemaVersion` | no | `integer (int32)` | Gets the Tracon schema generation that wrote `State`. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `stateMafVersion` | no | `string` | Gets the Microsoft Agent Framework package version that produced `State`. | — |