# RunScore

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

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

A human (or judge) score for a run or for a single message within a run.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `id` | no | `string (uuid)` | The score's identifier. | — |
| `tenantId` | yes | `string` | The tenant. | — |
| `runId` | yes | `string (uuid)` | The identifier of the run being scored. | — |
| `messageId` | no | `string` | The identifier of the message being scored. If empty, the score belongs to the whole run. | — |
| `name` | yes | `string` | The score's stable, low-cardinality name — part of the uniqueness key. | — |
| `kind` | yes | [`RunScoreKind`](/http-api/schemas/runscorekind/) | The shape of the value. | — |
| `value` | no | `number (double)` | The numeric value: 0/1 for RunScoreKind.Binary, 1 to 5 for RunScoreKind.Stars, 0 to 100 for RunScoreKind.Numeric. | pattern `^-?(?:0\\|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$` |
| `textValue` | no | `string` | The categorical value. Set only for a RunScoreKind.Categorical score. | — |
| `comment` | no | `string` | A free-text comment. | — |
| `source` | yes | `string` | The score's source: `human`, `api`, or `judge:{name}`. | — |
| `author` | no | `string` | The actor who gave the score. `null` in an identity-less setup. | — |
| `createdAt` | no | `string (date-time)` | The creation/last-updated time. | — |
| `evaluatorVersion` | no | `string` | The version of the component that produced this score, when one is known. | — |