Introduction

So, what’s a mutation? It sounds quite intimidating. Luckily, they are fairly straightforward.

A mutation is just another type of field in a GraphQL schema, the same as a query. In this case, though, a mutation is a standard way to modify server-side data.

In theory, any GraphQL operation could alter server-side data, but the convention is to use the mutation field type to accomplish this.

As the GraphQL specification notes, REST APIs do not prevent you from modifying data via a GET request. But in practice, the convention is to do this with a POST. The same applies in GraphQL. To modify data, use a mutation.

The structure of a mutation

Mutations have a similar structure to queries in that they consist of the field name and the arguments that it ...