GAP-1002: @cacheControl Directive
Version: 2026-02
Authors: Avery Chen
Discussion: github.com/graphql/gaps/pull/1002
GAP-1002: @cacheControl Directive
This release records the initial cache hint directive.
1Overview
The directive MAY appear on field definitions.
Example № 1directive @cacheControl(maxAge: Int) on FIELD_DEFINITION
2Motivation
The first release only standardizes a max age hint so implementations can interoperate on the simplest cache policy.
3Hint composition
An implementation SHOULD prefer the lower maxAge when multiple fields contribute to the same response.