How to use this reference
Editorial lesson: specify when permission changes must become observable and align decision freshness with that requirement. Review cache invalidation and performance assumptions together; a newly issued request does not necessarily use newly changed authorization state.
Before reading
- Relationship-based authorization and cache consistency concepts
Context and limits
- The documentation says caching is disabled by default. Do not assume every deployment returns cached authorization decisions.
- Its illustrative timestamp branch appears inconsistent with the prose; this record does not reproduce or endorse that example.
- Consistency tokens are described as future work. This guidance establishes neither a deployment-specific freshness guarantee nor evidence of an incident.
Sources and provenance
- Query Consistency Modes OpenFGA · reviewed 2026-10-03
Record reviewed 2026-10-03. Snapshot d5550c789111. Open the complete JSON contract.