# SessionRecord

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

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

A stored session.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `id` | yes | `string` | The session identifier. | — |
| `agentName` | yes | `string` | The agent the session belongs to. | — |
| `state` | yes | [`JsonElement`](/http-api/schemas/jsonelement/) | The serialized session state. Microsoft Agent Framework's `SerializeSessionAsync` output, treated as opaque. | — |
| `createdAt` | yes | `string (date-time)` | The creation time (UTC). | — |
| `updatedAt` | yes | `string (date-time)` | The last-updated time (UTC). | — |
| `tenantId` | no | `string` | The tenant identifier. | — |
| `ownerId` | no | `string` | The user the session belongs to, or `null` when the session is unowned. | — |
| `stateSchemaVersion` | no | `integer (int32)` | The Tracon schema generation that wrote `State`. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `stateMafVersion` | no | `string` | The Microsoft Agent Framework package version that produced `State`. | — |
| `version` | no | `integer (int64)` | The record's write generation, used for optimistic concurrency. | pattern `^-?(?:0\\|[1-9]\d*)$` |