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.

  1. 1Overview
  2. 2Motivation
  3. 3Hint composition