Mutations

GraphQL mutations are used to modify server-side data (i.e. write, update or delete data). As with queries, mutation fields are auto-generated based on the Postgres schema. Here’s a sample mutation field from our reference author/article schema:

insert_article (
  objects: [article_insert_input!]!
  on_conflict: article_on_conflict
): article_mutation_response

# response of any mutation on the table "article"
type article_mutation_response {
  # number of affected rows by the mutation
  affected_rows: Int!
  #data of the affected rows by the mutation
  returning: [author!]!
}

As you can see from the schema, you can:

  1. Pass multiple objects to the mutation.
  2. Return objects (with nested objects) from the affected rows in the response.

Let’s use this reference author/article schema to look at different types of mutations.