@vendure/docs 0.0.0-202601161959 → 0.0.0-202601201656

package/docs/reference/graphql-api/shop/mutations.mdx

@@ -2,430 +2,539 @@
 title: "Mutations"
 generated: true
 ---
-<!-- This file was generated from the Vendure source. Do not modify. Instead, re-run the "docs:build" script -->
 
 
 
-## addItemToOrder
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Adds an item to the Order. If custom fields are defined on the OrderLine entity, a third argument 'customFields' will be available.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">addItemToOrder(productVariantId: <a href="/reference/graphql-api/shop/object-types#id">ID</a>!, quantity: <a href="/reference/graphql-api/shop/object-types#int">Int</a>!): <a href="/reference/graphql-api/shop/object-types#updateorderitemsresult">UpdateOrderItemsResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## addItemsToOrder
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Adds mutliple items to the Order. Returns a list of errors for each item that failed to add. It will still add successful items.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">addItemsToOrder(inputs: [<a href="/reference/graphql-api/shop/input-types#additeminput">AddItemInput</a>!]!): <a href="/reference/graphql-api/shop/object-types#updatemultipleorderitemsresult">UpdateMultipleOrderItemsResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## addPaymentToOrder
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Add a Payment to the Order</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">addPaymentToOrder(input: <a href="/reference/graphql-api/shop/input-types#paymentinput">PaymentInput</a>!): <a href="/reference/graphql-api/shop/object-types#addpaymenttoorderresult">AddPaymentToOrderResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## adjustOrderLine
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Adjusts an OrderLine. If custom fields are defined on the OrderLine entity, a third argument 'customFields' of type <code>OrderLineCustomFieldsInput</code> will be available.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">adjustOrderLine(orderLineId: <a href="/reference/graphql-api/shop/object-types#id">ID</a>!, quantity: <a href="/reference/graphql-api/shop/object-types#int">Int</a>!): <a href="/reference/graphql-api/shop/object-types#updateorderitemsresult">UpdateOrderItemsResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## applyCouponCode
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Applies the given coupon code to the active Order</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">applyCouponCode(couponCode: <a href="/reference/graphql-api/shop/object-types#string">String</a>!): <a href="/reference/graphql-api/shop/object-types#applycouponcoderesult">ApplyCouponCodeResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## authenticate
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Authenticates the user using a named authentication strategy</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">authenticate(input: <a href="/reference/graphql-api/shop/input-types#authenticationinput">AuthenticationInput</a>!, rememberMe: <a href="/reference/graphql-api/shop/object-types#boolean">Boolean</a>): <a href="/reference/graphql-api/shop/object-types#authenticationresult">AuthenticationResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## createCustomerAddress
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Create a new Customer Address</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">createCustomerAddress(input: <a href="/reference/graphql-api/shop/input-types#createaddressinput">CreateAddressInput</a>!): <a href="/reference/graphql-api/shop/object-types#address">Address</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## deleteCustomerAddress
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Delete an existing Address</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">deleteCustomerAddress(id: <a href="/reference/graphql-api/shop/object-types#id">ID</a>!): <a href="/reference/graphql-api/shop/object-types#success">Success</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## login
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Authenticates the user using the native authentication strategy. This mutation is an alias for authenticate(&#123; native: &#123; ... &#125;&#125;)</div>
-
-<div class="graphql-code-line top-level comment"></div>
-
-<div class="graphql-code-line top-level comment">The <code>rememberMe</code> option applies when using cookie-based sessions, and if <code>true</code> it will set the maxAge of the session cookie</div>
-
-<div class="graphql-code-line top-level comment">to 1 year.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">login(username: <a href="/reference/graphql-api/shop/object-types#string">String</a>!, password: <a href="/reference/graphql-api/shop/object-types#string">String</a>!, rememberMe: <a href="/reference/graphql-api/shop/object-types#boolean">Boolean</a>): <a href="/reference/graphql-api/shop/object-types#nativeauthenticationresult">NativeAuthenticationResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## logout
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">End the current authenticated session</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">logout: <a href="/reference/graphql-api/shop/object-types#success">Success</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## refreshCustomerVerification
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Regenerate and send a verification token for a new Customer registration. Only applicable if <code>authOptions.requireVerification</code> is set to true.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">refreshCustomerVerification(emailAddress: <a href="/reference/graphql-api/shop/object-types#string">String</a>!): <a href="/reference/graphql-api/shop/object-types#refreshcustomerverificationresult">RefreshCustomerVerificationResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## registerCustomerAccount
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Register a Customer account with the given credentials. There are three possible registration flows:</div>
-
-<div class="graphql-code-line top-level comment"></div>
-
-<div class="graphql-code-line top-level comment">_If <code>authOptions.requireVerification</code> is set to `true`:_</div>
-
-<div class="graphql-code-line top-level comment"></div>
-
-<div class="graphql-code-line top-level comment">1. **The Customer is registered _with_ a password**. A verificationToken will be created (and typically emailed to the Customer). That</div>
-
-<div class="graphql-code-line top-level comment">   verificationToken would then be passed to the <code>verifyCustomerAccount</code> mutation _without_ a password. The Customer is then</div>
-
-<div class="graphql-code-line top-level comment">   verified and authenticated in one step.</div>
-
-<div class="graphql-code-line top-level comment">2. **The Customer is registered _without_ a password**. A verificationToken will be created (and typically emailed to the Customer). That</div>
-
-<div class="graphql-code-line top-level comment">   verificationToken would then be passed to the <code>verifyCustomerAccount</code> mutation _with_ the chosen password of the Customer. The Customer is then</div>
-
-<div class="graphql-code-line top-level comment">   verified and authenticated in one step.</div>
-
-<div class="graphql-code-line top-level comment"></div>
-
-<div class="graphql-code-line top-level comment">_If <code>authOptions.requireVerification</code> is set to `false`:_</div>
-
-<div class="graphql-code-line top-level comment"></div>
-
-<div class="graphql-code-line top-level comment">3. The Customer _must_ be registered _with_ a password. No further action is needed - the Customer is able to authenticate immediately.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">registerCustomerAccount(input: <a href="/reference/graphql-api/shop/input-types#registercustomerinput">RegisterCustomerInput</a>!): <a href="/reference/graphql-api/shop/object-types#registercustomeraccountresult">RegisterCustomerAccountResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## removeAllOrderLines
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Remove all OrderLine from the Order</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">removeAllOrderLines: <a href="/reference/graphql-api/shop/object-types#removeorderitemsresult">RemoveOrderItemsResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## removeCouponCode
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Removes the given coupon code from the active Order</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">removeCouponCode(couponCode: <a href="/reference/graphql-api/shop/object-types#string">String</a>!): <a href="/reference/graphql-api/shop/object-types#order">Order</a></div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## removeOrderLine
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Remove an OrderLine from the Order</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">removeOrderLine(orderLineId: <a href="/reference/graphql-api/shop/object-types#id">ID</a>!): <a href="/reference/graphql-api/shop/object-types#removeorderitemsresult">RemoveOrderItemsResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## requestPasswordReset
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Requests a password reset email to be sent</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">requestPasswordReset(emailAddress: <a href="/reference/graphql-api/shop/object-types#string">String</a>!): <a href="/reference/graphql-api/shop/object-types#requestpasswordresetresult">RequestPasswordResetResult</a></div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## requestUpdateCustomerEmailAddress
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Request to update the emailAddress of the active Customer. If <code>authOptions.requireVerification</code> is enabled</div>
-
-<div class="graphql-code-line top-level comment">(as is the default), then the <code>identifierChangeToken</code> will be assigned to the current User and</div>
-
-<div class="graphql-code-line top-level comment">a IdentifierChangeRequestEvent will be raised. This can then be used e.g. by the EmailPlugin to email</div>
-
-<div class="graphql-code-line top-level comment">that verification token to the Customer, which is then used to verify the change of email address.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">requestUpdateCustomerEmailAddress(password: <a href="/reference/graphql-api/shop/object-types#string">String</a>!, newEmailAddress: <a href="/reference/graphql-api/shop/object-types#string">String</a>!): <a href="/reference/graphql-api/shop/object-types#requestupdatecustomeremailaddressresult">RequestUpdateCustomerEmailAddressResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## resetPassword
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Resets a Customer's password based on the provided token</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">resetPassword(token: <a href="/reference/graphql-api/shop/object-types#string">String</a>!, password: <a href="/reference/graphql-api/shop/object-types#string">String</a>!): <a href="/reference/graphql-api/shop/object-types#resetpasswordresult">ResetPasswordResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## setCustomerForOrder
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Set the Customer for the Order. Required only if the Customer is not currently logged in</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">setCustomerForOrder(input: <a href="/reference/graphql-api/shop/input-types#createcustomerinput">CreateCustomerInput</a>!): <a href="/reference/graphql-api/shop/object-types#setcustomerfororderresult">SetCustomerForOrderResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## setOrderBillingAddress
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Sets the billing address for the active Order</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">setOrderBillingAddress(input: <a href="/reference/graphql-api/shop/input-types#createaddressinput">CreateAddressInput</a>!): <a href="/reference/graphql-api/shop/object-types#activeorderresult">ActiveOrderResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## setOrderCustomFields
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Allows any custom fields to be set for the active Order</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">setOrderCustomFields(input: <a href="/reference/graphql-api/shop/input-types#updateorderinput">UpdateOrderInput</a>!): <a href="/reference/graphql-api/shop/object-types#activeorderresult">ActiveOrderResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## setOrderShippingAddress
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Sets the shipping address for the active Order</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">setOrderShippingAddress(input: <a href="/reference/graphql-api/shop/input-types#createaddressinput">CreateAddressInput</a>!): <a href="/reference/graphql-api/shop/object-types#activeorderresult">ActiveOrderResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## setOrderShippingMethod
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Sets the shipping method by id, which can be obtained with the <code>eligibleShippingMethods</code> query.</div>
-
-<div class="graphql-code-line top-level comment">An Order can have multiple shipping methods, in which case you can pass an array of ids. In this case,</div>
-
-<div class="graphql-code-line top-level comment">you should configure a custom ShippingLineAssignmentStrategy in order to know which OrderLines each</div>
-
-<div class="graphql-code-line top-level comment">shipping method will apply to.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">setOrderShippingMethod(shippingMethodId: [<a href="/reference/graphql-api/shop/object-types#id">ID</a>!]!): <a href="/reference/graphql-api/shop/object-types#setordershippingmethodresult">SetOrderShippingMethodResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## transitionOrderToState
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Transitions an Order to a new state. Valid next states can be found by querying `nextOrderStates`</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">transitionOrderToState(state: <a href="/reference/graphql-api/shop/object-types#string">String</a>!): <a href="/reference/graphql-api/shop/object-types#transitionordertostateresult">TransitionOrderToStateResult</a></div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## unsetOrderBillingAddress
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Unsets the billing address for the active Order. Available since version 3.1.0</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">unsetOrderBillingAddress: <a href="/reference/graphql-api/shop/object-types#activeorderresult">ActiveOrderResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## unsetOrderShippingAddress
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Unsets the shipping address for the active Order. Available since version 3.1.0</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">unsetOrderShippingAddress: <a href="/reference/graphql-api/shop/object-types#activeorderresult">ActiveOrderResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## updateCustomer
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Update an existing Customer</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">updateCustomer(input: <a href="/reference/graphql-api/shop/input-types#updatecustomerinput">UpdateCustomerInput</a>!): <a href="/reference/graphql-api/shop/object-types#customer">Customer</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## updateCustomerAddress
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Update an existing Address</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">updateCustomerAddress(input: <a href="/reference/graphql-api/shop/input-types#updateaddressinput">UpdateAddressInput</a>!): <a href="/reference/graphql-api/shop/object-types#address">Address</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## updateCustomerEmailAddress
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Confirm the update of the emailAddress with the provided token, which has been generated by the</div>
-
-<div class="graphql-code-line top-level comment">`requestUpdateCustomerEmailAddress` mutation.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">updateCustomerEmailAddress(token: <a href="/reference/graphql-api/shop/object-types#string">String</a>!): <a href="/reference/graphql-api/shop/object-types#updatecustomeremailaddressresult">UpdateCustomerEmailAddressResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## updateCustomerPassword
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Update the password of the active Customer</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">updateCustomerPassword(currentPassword: <a href="/reference/graphql-api/shop/object-types#string">String</a>!, newPassword: <a href="/reference/graphql-api/shop/object-types#string">String</a>!): <a href="/reference/graphql-api/shop/object-types#updatecustomerpasswordresult">UpdateCustomerPasswordResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
-
-## verifyCustomerAccount
-<div class="graphql-code-block">
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level comment">Verify a Customer email address with the token sent to that address. Only applicable if <code>authOptions.requireVerification</code> is set to true.</div>
-
-<div class="graphql-code-line top-level comment"></div>
-
-<div class="graphql-code-line top-level comment">If the Customer was not registered with a password in the <code>registerCustomerAccount</code> mutation, the password _must_ be</div>
-
-<div class="graphql-code-line top-level comment">provided here.</div>
-<div class="graphql-code-line top-level comment">"""</div>
-<div class="graphql-code-line top-level">type <span class="graphql-code-identifier">Mutation</span> &#123;</div>
-<div class="graphql-code-line ">verifyCustomerAccount(token: <a href="/reference/graphql-api/shop/object-types#string">String</a>!, password: <a href="/reference/graphql-api/shop/object-types#string">String</a>): <a href="/reference/graphql-api/shop/object-types#verifycustomeraccountresult">VerifyCustomerAccountResult</a>!</div>
-
-
-<div class="graphql-code-line top-level">&#125;</div>
-</div>
+## addItemToOrder {#additemtoorder}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="addItemToOrder"
+  typeLinks={{
+    UpdateOrderItemsResult: '/reference/graphql-api/shop/object-types#updateorderitemsresult',
+    ID: '/reference/graphql-api/shop/object-types#id',
+    Int: '/reference/graphql-api/shop/object-types#int',
+  }}
+>
+{`"""Adds an item to the Order. If custom fields are defined on the OrderLine entity, a third argument 'customFields' will be available."""
+type Mutation {
+  addItemToOrder(productVariantId: ID!, quantity: Int!): UpdateOrderItemsResult!
+}`}
+</GraphQLDoc>
+
+## addItemsToOrder {#additemstoorder}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="addItemsToOrder"
+  typeLinks={{
+    UpdateMultipleOrderItemsResult: '/reference/graphql-api/shop/object-types#updatemultipleorderitemsresult',
+    AddItemInput: '/reference/graphql-api/shop/input-types#additeminput',
+  }}
+>
+{`"""Adds mutliple items to the Order. Returns a list of errors for each item that failed to add. It will still add successful items."""
+type Mutation {
+  addItemsToOrder(inputs: [AddItemInput!]!): UpdateMultipleOrderItemsResult!
+}`}
+</GraphQLDoc>
+
+## addPaymentToOrder {#addpaymenttoorder}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="addPaymentToOrder"
+  typeLinks={{
+    AddPaymentToOrderResult: '/reference/graphql-api/shop/object-types#addpaymenttoorderresult',
+    PaymentInput: '/reference/graphql-api/shop/input-types#paymentinput',
+  }}
+>
+{`"""Add a Payment to the Order"""
+type Mutation {
+  addPaymentToOrder(input: PaymentInput!): AddPaymentToOrderResult!
+}`}
+</GraphQLDoc>
+
+## adjustOrderLine {#adjustorderline}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="adjustOrderLine"
+  typeLinks={{
+    UpdateOrderItemsResult: '/reference/graphql-api/shop/object-types#updateorderitemsresult',
+    ID: '/reference/graphql-api/shop/object-types#id',
+    Int: '/reference/graphql-api/shop/object-types#int',
+  }}
+>
+{`"""Adjusts an OrderLine. If custom fields are defined on the OrderLine entity, a third argument 'customFields' of type \`OrderLineCustomFieldsInput\` will be available."""
+type Mutation {
+  adjustOrderLine(orderLineId: ID!, quantity: Int!): UpdateOrderItemsResult!
+}`}
+</GraphQLDoc>
+
+## applyCouponCode {#applycouponcode}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="applyCouponCode"
+  typeLinks={{
+    ApplyCouponCodeResult: '/reference/graphql-api/shop/object-types#applycouponcoderesult',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""Applies the given coupon code to the active Order"""
+type Mutation {
+  applyCouponCode(couponCode: String!): ApplyCouponCodeResult!
+}`}
+</GraphQLDoc>
+
+## authenticate {#authenticate}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="authenticate"
+  typeLinks={{
+    AuthenticationResult: '/reference/graphql-api/shop/object-types#authenticationresult',
+    AuthenticationInput: '/reference/graphql-api/shop/input-types#authenticationinput',
+    Boolean: '/reference/graphql-api/shop/object-types#boolean',
+  }}
+>
+{`"""Authenticates the user using a named authentication strategy"""
+type Mutation {
+  authenticate(input: AuthenticationInput!, rememberMe: Boolean): AuthenticationResult!
+}`}
+</GraphQLDoc>
+
+## createCustomerAddress {#createcustomeraddress}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="createCustomerAddress"
+  typeLinks={{
+    Address: '/reference/graphql-api/shop/object-types#address',
+    CreateAddressInput: '/reference/graphql-api/shop/input-types#createaddressinput',
+  }}
+>
+{`"""Create a new Customer Address"""
+type Mutation {
+  createCustomerAddress(input: CreateAddressInput!): Address!
+}`}
+</GraphQLDoc>
+
+## deleteCustomerAddress {#deletecustomeraddress}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="deleteCustomerAddress"
+  typeLinks={{
+    Success: '/reference/graphql-api/shop/object-types#success',
+    ID: '/reference/graphql-api/shop/object-types#id',
+  }}
+>
+{`"""Delete an existing Address"""
+type Mutation {
+  deleteCustomerAddress(id: ID!): Success!
+}`}
+</GraphQLDoc>
+
+## login {#login}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="login"
+  typeLinks={{
+    NativeAuthenticationResult: '/reference/graphql-api/shop/object-types#nativeauthenticationresult',
+    String: '/reference/graphql-api/shop/object-types#string',
+    Boolean: '/reference/graphql-api/shop/object-types#boolean',
+  }}
+>
+{`"""
+Authenticates the user using the native authentication strategy. This mutation is an alias for authenticate({ native: { ... }})
+
+The \`rememberMe\` option applies when using cookie-based sessions, and if \`true\` it will set the maxAge of the session cookie
+to 1 year.
+"""
+type Mutation {
+  login(username: String!, password: String!, rememberMe: Boolean): NativeAuthenticationResult!
+}`}
+</GraphQLDoc>
+
+## logout {#logout}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="logout"
+  typeLinks={{
+    Success: '/reference/graphql-api/shop/object-types#success',
+  }}
+>
+{`"""End the current authenticated session"""
+type Mutation {
+  logout: Success!
+}`}
+</GraphQLDoc>
+
+## refreshCustomerVerification {#refreshcustomerverification}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="refreshCustomerVerification"
+  typeLinks={{
+    RefreshCustomerVerificationResult: '/reference/graphql-api/shop/object-types#refreshcustomerverificationresult',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""Regenerate and send a verification token for a new Customer registration. Only applicable if \`authOptions.requireVerification\` is set to true."""
+type Mutation {
+  refreshCustomerVerification(emailAddress: String!): RefreshCustomerVerificationResult!
+}`}
+</GraphQLDoc>
+
+## registerCustomerAccount {#registercustomeraccount}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="registerCustomerAccount"
+  typeLinks={{
+    RegisterCustomerAccountResult: '/reference/graphql-api/shop/object-types#registercustomeraccountresult',
+    RegisterCustomerInput: '/reference/graphql-api/shop/input-types#registercustomerinput',
+  }}
+>
+{`"""
+Register a Customer account with the given credentials. There are three possible registration flows:
+
+_If \`authOptions.requireVerification\` is set to \`true\`:_
+
+1. **The Customer is registered _with_ a password**. A verificationToken will be created (and typically emailed to the Customer). That
+   verificationToken would then be passed to the \`verifyCustomerAccount\` mutation _without_ a password. The Customer is then
+   verified and authenticated in one step.
+2. **The Customer is registered _without_ a password**. A verificationToken will be created (and typically emailed to the Customer). That
+   verificationToken would then be passed to the \`verifyCustomerAccount\` mutation _with_ the chosen password of the Customer. The Customer is then
+   verified and authenticated in one step.
+
+_If \`authOptions.requireVerification\` is set to \`false\`:_
+
+3. The Customer _must_ be registered _with_ a password. No further action is needed - the Customer is able to authenticate immediately.
+"""
+type Mutation {
+  registerCustomerAccount(input: RegisterCustomerInput!): RegisterCustomerAccountResult!
+}`}
+</GraphQLDoc>
+
+## removeAllOrderLines {#removeallorderlines}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="removeAllOrderLines"
+  typeLinks={{
+    RemoveOrderItemsResult: '/reference/graphql-api/shop/object-types#removeorderitemsresult',
+  }}
+>
+{`"""Remove all OrderLine from the Order"""
+type Mutation {
+  removeAllOrderLines: RemoveOrderItemsResult!
+}`}
+</GraphQLDoc>
+
+## removeCouponCode {#removecouponcode}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="removeCouponCode"
+  typeLinks={{
+    Order: '/reference/graphql-api/shop/object-types#order',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""Removes the given coupon code from the active Order"""
+type Mutation {
+  removeCouponCode(couponCode: String!): Order
+}`}
+</GraphQLDoc>
+
+## removeOrderLine {#removeorderline}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="removeOrderLine"
+  typeLinks={{
+    RemoveOrderItemsResult: '/reference/graphql-api/shop/object-types#removeorderitemsresult',
+    ID: '/reference/graphql-api/shop/object-types#id',
+  }}
+>
+{`"""Remove an OrderLine from the Order"""
+type Mutation {
+  removeOrderLine(orderLineId: ID!): RemoveOrderItemsResult!
+}`}
+</GraphQLDoc>
+
+## requestPasswordReset {#requestpasswordreset}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="requestPasswordReset"
+  typeLinks={{
+    RequestPasswordResetResult: '/reference/graphql-api/shop/object-types#requestpasswordresetresult',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""Requests a password reset email to be sent"""
+type Mutation {
+  requestPasswordReset(emailAddress: String!): RequestPasswordResetResult
+}`}
+</GraphQLDoc>
+
+## requestUpdateCustomerEmailAddress {#requestupdatecustomeremailaddress}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="requestUpdateCustomerEmailAddress"
+  typeLinks={{
+    RequestUpdateCustomerEmailAddressResult: '/reference/graphql-api/shop/object-types#requestupdatecustomeremailaddressresult',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""
+Request to update the emailAddress of the active Customer. If \`authOptions.requireVerification\` is enabled
+(as is the default), then the \`identifierChangeToken\` will be assigned to the current User and
+a IdentifierChangeRequestEvent will be raised. This can then be used e.g. by the EmailPlugin to email
+that verification token to the Customer, which is then used to verify the change of email address.
+"""
+type Mutation {
+  requestUpdateCustomerEmailAddress(password: String!, newEmailAddress: String!): RequestUpdateCustomerEmailAddressResult!
+}`}
+</GraphQLDoc>
+
+## resetPassword {#resetpassword}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="resetPassword"
+  typeLinks={{
+    ResetPasswordResult: '/reference/graphql-api/shop/object-types#resetpasswordresult',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""Resets a Customer's password based on the provided token"""
+type Mutation {
+  resetPassword(token: String!, password: String!): ResetPasswordResult!
+}`}
+</GraphQLDoc>
+
+## setCustomerForOrder {#setcustomerfororder}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="setCustomerForOrder"
+  typeLinks={{
+    SetCustomerForOrderResult: '/reference/graphql-api/shop/object-types#setcustomerfororderresult',
+    CreateCustomerInput: '/reference/graphql-api/shop/input-types#createcustomerinput',
+  }}
+>
+{`"""Set the Customer for the Order. Required only if the Customer is not currently logged in"""
+type Mutation {
+  setCustomerForOrder(input: CreateCustomerInput!): SetCustomerForOrderResult!
+}`}
+</GraphQLDoc>
+
+## setOrderBillingAddress {#setorderbillingaddress}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="setOrderBillingAddress"
+  typeLinks={{
+    ActiveOrderResult: '/reference/graphql-api/shop/object-types#activeorderresult',
+    CreateAddressInput: '/reference/graphql-api/shop/input-types#createaddressinput',
+  }}
+>
+{`"""Sets the billing address for the active Order"""
+type Mutation {
+  setOrderBillingAddress(input: CreateAddressInput!): ActiveOrderResult!
+}`}
+</GraphQLDoc>
+
+## setOrderCustomFields {#setordercustomfields}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="setOrderCustomFields"
+  typeLinks={{
+    ActiveOrderResult: '/reference/graphql-api/shop/object-types#activeorderresult',
+    UpdateOrderInput: '/reference/graphql-api/shop/input-types#updateorderinput',
+  }}
+>
+{`"""Allows any custom fields to be set for the active Order"""
+type Mutation {
+  setOrderCustomFields(input: UpdateOrderInput!): ActiveOrderResult!
+}`}
+</GraphQLDoc>
+
+## setOrderShippingAddress {#setordershippingaddress}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="setOrderShippingAddress"
+  typeLinks={{
+    ActiveOrderResult: '/reference/graphql-api/shop/object-types#activeorderresult',
+    CreateAddressInput: '/reference/graphql-api/shop/input-types#createaddressinput',
+  }}
+>
+{`"""Sets the shipping address for the active Order"""
+type Mutation {
+  setOrderShippingAddress(input: CreateAddressInput!): ActiveOrderResult!
+}`}
+</GraphQLDoc>
+
+## setOrderShippingMethod {#setordershippingmethod}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="setOrderShippingMethod"
+  typeLinks={{
+    SetOrderShippingMethodResult: '/reference/graphql-api/shop/object-types#setordershippingmethodresult',
+    ID: '/reference/graphql-api/shop/object-types#id',
+  }}
+>
+{`"""
+Sets the shipping method by id, which can be obtained with the \`eligibleShippingMethods\` query.
+An Order can have multiple shipping methods, in which case you can pass an array of ids. In this case,
+you should configure a custom ShippingLineAssignmentStrategy in order to know which OrderLines each
+shipping method will apply to.
+"""
+type Mutation {
+  setOrderShippingMethod(shippingMethodId: [ID!]!): SetOrderShippingMethodResult!
+}`}
+</GraphQLDoc>
+
+## transitionOrderToState {#transitionordertostate}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="transitionOrderToState"
+  typeLinks={{
+    TransitionOrderToStateResult: '/reference/graphql-api/shop/object-types#transitionordertostateresult',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""Transitions an Order to a new state. Valid next states can be found by querying \`nextOrderStates\`"""
+type Mutation {
+  transitionOrderToState(state: String!): TransitionOrderToStateResult
+}`}
+</GraphQLDoc>
+
+## unsetOrderBillingAddress {#unsetorderbillingaddress}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="unsetOrderBillingAddress"
+  typeLinks={{
+    ActiveOrderResult: '/reference/graphql-api/shop/object-types#activeorderresult',
+  }}
+>
+{`"""Unsets the billing address for the active Order. Available since version 3.1.0"""
+type Mutation {
+  unsetOrderBillingAddress: ActiveOrderResult!
+}`}
+</GraphQLDoc>
+
+## unsetOrderShippingAddress {#unsetordershippingaddress}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="unsetOrderShippingAddress"
+  typeLinks={{
+    ActiveOrderResult: '/reference/graphql-api/shop/object-types#activeorderresult',
+  }}
+>
+{`"""Unsets the shipping address for the active Order. Available since version 3.1.0"""
+type Mutation {
+  unsetOrderShippingAddress: ActiveOrderResult!
+}`}
+</GraphQLDoc>
+
+## updateCustomer {#updatecustomer}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="updateCustomer"
+  typeLinks={{
+    Customer: '/reference/graphql-api/shop/object-types#customer',
+    UpdateCustomerInput: '/reference/graphql-api/shop/input-types#updatecustomerinput',
+  }}
+>
+{`"""Update an existing Customer"""
+type Mutation {
+  updateCustomer(input: UpdateCustomerInput!): Customer!
+}`}
+</GraphQLDoc>
+
+## updateCustomerAddress {#updatecustomeraddress}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="updateCustomerAddress"
+  typeLinks={{
+    Address: '/reference/graphql-api/shop/object-types#address',
+    UpdateAddressInput: '/reference/graphql-api/shop/input-types#updateaddressinput',
+  }}
+>
+{`"""Update an existing Address"""
+type Mutation {
+  updateCustomerAddress(input: UpdateAddressInput!): Address!
+}`}
+</GraphQLDoc>
+
+## updateCustomerEmailAddress {#updatecustomeremailaddress}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="updateCustomerEmailAddress"
+  typeLinks={{
+    UpdateCustomerEmailAddressResult: '/reference/graphql-api/shop/object-types#updatecustomeremailaddressresult',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""
+Confirm the update of the emailAddress with the provided token, which has been generated by the
+\`requestUpdateCustomerEmailAddress\` mutation.
+"""
+type Mutation {
+  updateCustomerEmailAddress(token: String!): UpdateCustomerEmailAddressResult!
+}`}
+</GraphQLDoc>
+
+## updateCustomerPassword {#updatecustomerpassword}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="updateCustomerPassword"
+  typeLinks={{
+    UpdateCustomerPasswordResult: '/reference/graphql-api/shop/object-types#updatecustomerpasswordresult',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""Update the password of the active Customer"""
+type Mutation {
+  updateCustomerPassword(currentPassword: String!, newPassword: String!): UpdateCustomerPasswordResult!
+}`}
+</GraphQLDoc>
+
+## verifyCustomerAccount {#verifycustomeraccount}
+
+<GraphQLDoc
+  type="mutation"
+  typeName="verifyCustomerAccount"
+  typeLinks={{
+    VerifyCustomerAccountResult: '/reference/graphql-api/shop/object-types#verifycustomeraccountresult',
+    String: '/reference/graphql-api/shop/object-types#string',
+  }}
+>
+{`"""
+Verify a Customer email address with the token sent to that address. Only applicable if \`authOptions.requireVerification\` is set to true.
+
+If the Customer was not registered with a password in the \`registerCustomerAccount\` mutation, the password _must_ be
+provided here.
+"""
+type Mutation {
+  verifyCustomerAccount(token: String!, password: String): VerifyCustomerAccountResult!
+}`}
+</GraphQLDoc>