Usando mutations aninhadas

As mutations aninhadas permitem realizar mutations em um tipo diferente do tipo raiz no GraphQL.

A query abaixo executa uma mutation padrão, usando o campo de mutation updatePost do tipo raiz:

mutation {
  updatePost(input: {
    id: 5,
    title: "New title"
  }) {
    status
    errors {
      __typename
      ...on ErrorPayload {
        message
      }
    }
    post {
      title
    }
  }
}

A query acima também pode ser executada por meio de uma mutation aninhada, onde o objeto post é primeiro consultado pelo campo post, e então o campo de mutation update, que pertence ao tipo Post, é aplicado sobre o objeto post:

mutation {
  post(by: {id: 5}) {
    update(input: {
      title: "New title"
    }) {
      status
      post {
        title
      }
    }
  }
}

As mutations também podem ser aninhadas, modificando dados no resultado de outra mutation:

mutation {
  createPost(input: {
    title: "First title"
  }) {
    status
    postID
    post {
      update(input: {
        title: "Second title",
        contentAs: { html: "Some content" }
      }) {
        status
        post {
          title
          content
          addComment(input: {
            commentAs: { html: "My first comment" }
          }) {
            status
            commentID
            comment {
              content
              date
            }
          }
        }
      }
    }
  }
}

Tipo raiz simplificado

As mutations aninhadas alteram o tipo raiz, de QueryRoot e MutationRoot para um único tipo Root que lida com queries e mutations:

Mutations aninhadas na documentação do schema

Visualizando campos de mutation

Use o cliente Voyager para visualizar quais são os campos de mutation.

Com mutations aninhadas, cada tipo no schema pode conter tanto campos de query quanto campos de mutation. Para diferenciá-los, a descrição do campo de mutation é precedida pela etiqueta "[Mutation] ".

Por exemplo, estes são os campos do tipo Root:

Descrição do tipo Root na documentação do GraphiQL