State API
Record facts as governed state.
Record a state item
POST /v1/state/items
Authorization: Bearer sk_live_...
Content-Type: application/json
{
"session_id": "sess_abc123",
"key": "claim.amount",
"value": "$48,200",
"type": "fact",
"source": "claims_system"
}Fields
| Field | Required | Description |
|---|---|---|
session_id | Yes | The session the fact belongs to |
key | Yes | Canonical key, lower-case and dotted; see Canonical keys |
value | Yes | The value as a string; it is normalised before comparison |
type | Yes | The state type, for example fact, decision or constraint |
source | Yes | Where the value came from, kept for tracing |
Last reviewed October 2026Suggest a change