Resolve Reality
GET /v1/reality?entity={entity}&factTopicSlug={topic}&scope={scopeJson}Resolves the current exact state for a given entity, FactTopic, and scope — the entry point for "what does this source currently say."
Query parameters
| Param | Required | Notes |
|---|---|---|
entity | Yes, unless entityId is given | The stable public identity of the tracked entity, e.g. "openai". Canonical — use this. |
entityId | Legacy alternative to entity | The raw internal entity id. Accepted for backward compatibility only; new integrations should use entity. |
factTopicSlug | Yes | The canonical public FactTopic identity — stable even if the underlying predicate version changes. |
scope | Yes | Canonical JSON scope object. Empty scope {} is valid; a missing scope is rejected. |
Exactly one of entity/entityId is required — supplying both, or neither, is INVALID_ARGUMENT.
Response — ResolvedRealityV1
Points at the current exact FactStateVersion for that entity/topic/scope. Fetch the full state with Exact States.
Errors specific to this route
| Code | Meaning |
|---|---|
ENTITY_NOT_FOUND | The entity value doesn't resolve to any known entity. |
FACT_TOPIC_NOT_FOUND | The factTopicSlug itself is unknown — no such FactTopic exists. |
REALITY_NOT_RESOLVED | The entity and factTopicSlug are both valid identities, but nothing is currently resolvable through them — either the topic has no active definition right now, or this exact scope has never been observed. A real, valid outcome, not an input error. |
See Errors for the full taxonomy.
Caching
This route is not cached as immutable — the "current" answer can change as new evidence is observed. Immutable routes are the ones addressed by an exact state id.