Setting up Mutations

A mutation is something that “mutates” or changes the data in the server. In DB terms, if we need to change the data in a table using graphql we need mutations — be it an INSERT, UPDATE or DELETE. Only SELECTs are covered with a Query.

So to add a new speaker to the database we need a mutation.

Graphql Mutations

In the GraphQL language, a mutation is of the form

mutation AddSpeaker($name:String, $talkTitle:String) {
  createSpeaker(name: $name, talkTitle:$talkTitle) {

A set of “query” variables needs to be supplied to the GraphQL endpoint. Say for example,

  "name": "John Doe",
  "talkTitle": "Introduction to GraphQL in Ruby"

Read more about GraphQL mutations and its syntax in the specifications —

For our little server to accept mutations, we need to make some changes and add more files for defining mutations. Lets see how, step-by-step.

Adding a Mutation root type

A mutation root MutationType has to be created and it should then be added to our Schema, like the QueryType that was added in the last post.

Get notified on engineering articles like this

Follow us on twitter @neumeralhq