Reality Locks

A Reality Lock freezes an immutable decision basis over one or more exact states — the thing your agent actually acted on — so you can check later whether that basis has changed.

Create a lock

POST /v1/locks
Authorization: Bearer {key}
Idempotency-Key: {uuid}
Content-Type: application/json

{"factStateVersionIds": ["..."]}

Requires an Idempotency-Key. Retrying the same key never creates a second lock — locks are immutable once created.

Fetch a lock

GET /v1/locks/{realityLockId}

Assess a lock

GET /v1/locks/{realityLockId}/assessment

Returns a RealityLockAssessmentV1 — whether the locked basis still holds, or has since changed. This is how an agent re-checks "is the thing I acted on still true."

MCP equivalents

create_reality_lock and assess_reality_lock — see MCP.