Skip to main content



What is it

GraphQL is an API query language. It enables stitching separate backend service APIs together into a single coherent API for frontend clients.

When to use it

Assess GraphQL as a way of aggregating multiple gRPC backend services into a single frontend-facing app-specific API.

Avoid cross-application dependencies

We currently advise against building separate applications on top of the same GraphQL API, since we are trying to avoid overambitious API gateways with unclear team ownership.

How to learn it

The main GraphQL site has great learning resources for understanding GraphQL independent of any language or framework.

To learn how to build a GraphQL API gateway in Go, see gqlgen.