Mutation — операция изменения данных на сервере (создание/обновление/удаление); по соглашению поля mutation выполняют side effects и возвращают результат.
Разбор
В одном документе mutations выполняются последовательно (в отличие от параллельных query fields — по спецификации).
Именование глаголами: createUser, updateOrder.
Возвращайте обновлённую сущность или payload с ошибками.
Идемпотентность проектируйте явно (ключи).
Пример
mutation {
createUser(input: { name: "Ada" }) {
id
name
}
}
Итог
Mutation — запись через GraphQL с типизированным ответом.