> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reilabs.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Observe value-learning evidence

> Submit value observations and application outcomes, inspect admission counts, and handle exact replays or conflicting record identities correctly.

Submit observations to the Adapt-1 value learner with stable identities. Each request accepts at most 50 observations and 50 application outcomes. See [value observations](https://docs.reilabs.org/docs/neuroadapt/value-observations.md) for supervision sources, comparison groups, partition requirements, and the observed atomic rejection and deduplication rules.

The tables below reproduce request fields from archived schema-version-5 build `0136121bd2cf9d4cdbcb114565c7e1ffb74c5a63`. A default marked "Not declared" is absent from that schema; it does not mean `null`. See [source and response notes](https://docs.reilabs.org/docs/neuroadapt/value-api.md#authentication-and-schema-source) for the evidence scope.

## Path, headers, and query

Send the hosted API key as `Authorization: Bearer <ADAPT1_API_KEY>`. The authenticated identity determines ownership; follow [HTTP and contracts](https://docs.reilabs.org/docs/neuroadapt/request-contracts.md) for the session placeholder.

| Parameter | Location | Required | Type | Constraints |
| - | - | - | - | - |
| `domain_id` | path | Yes | `string` | No further constraint declared |
| `X-Neuroadapt-Session-Id` | header | No | `string` or `null` | No further constraint declared |

`X-Neuroadapt-Session-Id` is a compatibility header present in the archived backend schema. It does not replace the hosted bearer identity.

## JSON body contract

Content type: `application/json`. The HTTP request body is required. The following table describes its fields; linked schema names lead to the complete nested definitions on this page. When an array type also permits `null`, that alternative applies to the entire field, not to individual array items.

## Request body

Schema: `ValueObserveRequest`.

Fields outside this object's declared properties are rejected by the schema.

| Field | Required | Type | Declared default | Constraints |
| - | - | - | - | - |
| `application_outcomes` | No | array of [ValueApplicationOutcome](#valueapplicationoutcome) | Not declared | At most 50 items |
| `observations` | No | array of [ValueObservation](#valueobservation) | Not declared | At most 50 items |
| `session_id` | Yes | `string` | Not declared | At least 1 character |

## ValueApplicationOutcome

Schema: `ValueApplicationOutcome`.

Fields outside this object's declared properties are rejected by the schema.

| Field | Required | Type | Declared default | Constraints |
| - | - | - | - | - |
| `case_id` | Yes | `string` | Not declared | 1 to 256 characters |
| `context_sha256` | Yes | `string` | Not declared | Pattern `^[0-9a-f]{64}$` |
| `model_sha256` | Yes | `string` | Not declared | Pattern `^[0-9a-f]{64}$` |
| `utility` | Yes | `number` | Not declared | Minimum `0`; Maximum `1` |

## ValueObservation

Schema: `ValueObservation`.

Fields outside this object's declared properties are rejected by the schema.

| Field | Required | Type | Declared default | Constraints |
| - | - | - | - | - |
| `conditions` | No | map of `number` values | Not declared | At most 16 properties |
| `context` | No | map of `number` values | Not declared | At most 16 properties |
| `continuation` | No | [ValueContinuation](#valuecontinuation) or `null` | Not declared | No further constraint declared |
| `episode_id` | Yes | `string` | Not declared | 1 to 256 characters |
| `include_moments` | No | `boolean` | `false` | No further constraint declared |
| `include_positions` | No | `boolean` | `true` | No further constraint declared |
| `metadata` | No | object | Not declared | Additional properties allowed |
| `objects` | No | array of object or `null` | Not declared | At most 512 items |
| `outcome` | No | [ValueOutcome](#valueoutcome) or `null` | Not declared | No further constraint declared |
| `policy_features` | No | map of `number` values | Not declared | At most 4096 properties |
| `record_id` | Yes | `string` | Not declared | 1 to 256 characters |
| `relations` | No | array of object | Not declared | At most 4096 items |
| `step` | Yes | `number` | Not declared | Minimum `0` |
| `target` | No | `number` or `null` | Not declared | Minimum `0`; Maximum `1` |

## ValueContinuation

Schema: `ValueContinuation`.

Fields outside this object's declared properties are rejected by the schema.

| Field | Required | Type | Declared default | Constraints |
| - | - | - | - | - |
| `discount` | No | `number` | `1` | Minimum `0`; Maximum `1` |
| `maximizing` | Yes | `boolean` | Not declared | No further constraint declared |
| `neutral` | No | `number` | `0.5` | Minimum `0`; Maximum `1` |
| `successors` | Yes | array of [ValueSuccessor](#valuesuccessor) | Not declared | 1 to 256 items |

## ValueOutcome

Schema: `ValueOutcome`.

Fields outside this object's declared properties are rejected by the schema.

| Field | Required | Type | Declared default | Constraints |
| - | - | - | - | - |
| `discount` | No | `number` | `1` | Minimum `0`; Maximum `1` |
| `neutral` | No | `number` | `0.5` | Minimum `0`; Maximum `1` |
| `terminal_step` | Yes | `number` | Not declared | Minimum `0` |
| `value` | Yes | `number` | Not declared | Minimum `0`; Maximum `1` |

## ValueSuccessor

Schema: `ValueSuccessor`.

Fields outside this object's declared properties are rejected by the schema.

| Field | Required | Type | Declared default | Constraints |
| - | - | - | - | - |
| `conditions` | No | map of `number` values | Not declared | At most 16 properties |
| `context` | No | map of `number` values | Not declared | At most 16 properties |
| `counterpart` | No | [ValueInput](#valueinput) or `null` | Not declared | No further constraint declared |
| `include_moments` | No | `boolean` | `false` | No further constraint declared |
| `include_positions` | No | `boolean` | `true` | No further constraint declared |
| `objects` | No | array of object or `null` | Not declared | At most 512 items |
| `policy_features` | No | map of `number` values | Not declared | At most 4096 properties |
| `relations` | No | array of object | Not declared | At most 4096 items |
| `terminal_value` | No | `number` or `null` | Not declared | Minimum `0`; Maximum `1` |

## ValueInput

Schema: `ValueInput`.

Fields outside this object's declared properties are rejected by the schema.

| Field | Required | Type | Declared default | Constraints |
| - | - | - | - | - |
| `conditions` | No | map of `number` values | Not declared | At most 16 properties |
| `context` | No | map of `number` values | Not declared | At most 16 properties |
| `include_moments` | No | `boolean` | `false` | No further constraint declared |
| `include_positions` | No | `boolean` | `true` | No further constraint declared |
| `objects` | No | array of object or `null` | Not declared | At most 512 items |
| `policy_features` | No | map of `number` values | Not declared | At most 4096 properties |
| `relations` | No | array of object | Not declared | At most 4096 items |

## Responses

| HTTP status | Archived contract |
| - | - |
| 200 | Successful JSON response. The archived schema does not type its properties. |
| 422 | Request validation error; the archived schema references `HTTPValidationError`. |

The archived validation shape has an optional `detail` array. Each validation entry requires `loc` (an array of strings or integers), `msg` (string), and `type` (string); it can also include `ctx` (object) and `input` (any JSON value). Recorded operational refusals can have their own error details.

For observed admission, atomic batch rejection, `record_id` duplicates, and HTTP `409` conflicts, use [value observations](https://docs.reilabs.org/docs/neuroadapt/value-observations.md). An `observations` entry must have exactly one supervision source even though this cross-field rule is not represented in the archived property table.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.