GAP-1002: @cacheControl Directive

This document defines a directive for expressing cache hints in a GraphQL schema.

1Overview

The directive MAY appear on object and field definitions.

Example № 1directive @cacheControl(
  maxAge: Int
  scope: CacheScope
) on OBJECT | FIELD_DEFINITION

enum CacheScope {
  PUBLIC
  PRIVATE
}

GraphQL services often need cache hints that are visible to a gateway without requiring custom runtime configuration for each field.

When more than one hint applies, an implementation SHOULD choose the most restrictive cache policy.