# 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/api/tracon.workflowcheckpointrecord/ > Summary: WorkflowCheckpointRecord: Represents a single checkpoint of a workflow run.

Namespace Tracon · Assembly Tracon.Abstractions.dll

Represents a single checkpoint of a workflow run. ```csharp public sealed record WorkflowCheckpointRecord : IEquatable ```

Inheritance: object ← WorkflowCheckpointRecord
Implements: IEquatable<WorkflowCheckpointRecord>
Inherited Members: object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

## Remarks [WorkflowCheckpointRecord.State](/api/tracon.workflowcheckpointrecord/#Tracon_WorkflowCheckpointRecord_State) is an **opaque** payload. Its content belongs to Microsoft Agent Framework and is polymorphic: it carries a `$type` discriminator, and that discriminator must be the *first* property of the object it appears in. Measured: a 7.5 KB checkpoint really does have the `{"$type":0,...}` discriminator first. For this reason the value is stored in a PostgreSQL `json` column, not a `jsonb` column: `jsonb` reorders keys and would move the discriminator out of first place. ## Constructors ### WorkflowCheckpointRecord ```csharp public WorkflowCheckpointRecord() ``` ## Properties ### CheckpointId Gets the checkpoint identifier. The value belongs to Tracon, not to Microsoft Agent Framework: `CreateAsync` generates it and hands it back to MAF. ```csharp public required string CheckpointId { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string) ### CreatedAt Gets the creation time (UTC). ```csharp public required DateTimeOffset CreatedAt { get; init; } ``` #### Property Value [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset) ### Id Gets the record identifier. A time-ordered UUID (v7). ```csharp public required Guid Id { get; init; } ``` #### Property Value [Guid](https://learn.microsoft.com/dotnet/api/system.guid) ### ParentCheckpointId Gets the identifier of the previous checkpoint. [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null) for the first checkpoint. ```csharp public string? ParentCheckpointId { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string)? ### RunId Gets the identifier of the run that produced this checkpoint. [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null) if no run was in progress when the checkpoint was written. ```csharp public Guid? RunId { get; init; } ``` #### Property Value [Guid](https://learn.microsoft.com/dotnet/api/system.guid)? ### SessionId Gets the identifier of the run session. Microsoft Agent Framework groups checkpoints under this value. ```csharp public required string SessionId { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string) ### State Gets the opaque run state. ```csharp public required JsonElement State { get; init; } ``` #### Property Value [JsonElement](https://learn.microsoft.com/dotnet/api/system.text.json.jsonelement) ### StateMafVersion Gets the Microsoft Agent Framework package version that produced `State`. ```csharp public string? StateMafVersion { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string)? #### Remarks [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null) means the row was written before this field existed. Tracon does not promise that a checkpoint written by one Microsoft Agent Framework version can be resumed by a different one; this value lets a failed resume report exactly which version wrote the state instead of guessing. ### StateSchemaVersion Gets the Tracon schema generation that wrote `State`. ```csharp public int? StateSchemaVersion { get; init; } ``` #### Property Value [int](https://learn.microsoft.com/dotnet/api/system.int32)? #### Remarks [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null) means the row was written before this field existed — unlike `SessionRecord.StateSchemaVersion`, checkpoints had no envelope stamp before this field was added. ### TenantId Gets the tenant the record belongs to. ```csharp public required string TenantId { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string) ## Methods ### Equals$object?$ ```csharp public override bool Equals(object? obj) ``` #### Parameters `obj` [object](https://learn.microsoft.com/dotnet/api/system.object)? #### Returns [bool](https://learn.microsoft.com/dotnet/api/system.boolean) ### Equals$WorkflowCheckpointRecord?$ ```csharp public bool Equals(WorkflowCheckpointRecord? other) ``` #### Parameters `other` [WorkflowCheckpointRecord](/api/tracon.workflowcheckpointrecord/)? #### Returns [bool](https://learn.microsoft.com/dotnet/api/system.boolean) ### GetHashCode ```csharp public override int GetHashCode() ``` #### Returns [int](https://learn.microsoft.com/dotnet/api/system.int32) ### ToString ```csharp public override string ToString() ``` #### Returns [string](https://learn.microsoft.com/dotnet/api/system.string) ## Operators ### operator ==$WorkflowCheckpointRecord?, WorkflowCheckpointRecord?$ ```csharp public static bool operator ==(WorkflowCheckpointRecord? left, WorkflowCheckpointRecord? right) ``` #### Parameters `left` [WorkflowCheckpointRecord](/api/tracon.workflowcheckpointrecord/)? `right` [WorkflowCheckpointRecord](/api/tracon.workflowcheckpointrecord/)? #### Returns [bool](https://learn.microsoft.com/dotnet/api/system.boolean) ### operator \!=$WorkflowCheckpointRecord?, WorkflowCheckpointRecord?$ ```csharp public static bool operator !=(WorkflowCheckpointRecord? left, WorkflowCheckpointRecord? right) ``` #### Parameters `left` [WorkflowCheckpointRecord](/api/tracon.workflowcheckpointrecord/)? `right` [WorkflowCheckpointRecord](/api/tracon.workflowcheckpointrecord/)? #### Returns [bool](https://learn.microsoft.com/dotnet/api/system.boolean)