title: "Mutations" weight: 2 date: 2023-07-04T11:02:07.589Z showtoc: true
Add Customers to a CustomerGroup
{{% gql-fields %}}
{{% gql-fields %}}
Adds an item to the draft Order.
{{% gql-fields %}}
Used to manually create a new Payment against an Order. This can be used by an Administrator when an Order is in the ArrangingPayment state.
It is also used when a completed Order
has been modified (using modifyOrder) and the price has increased. The extra payment
can then be manually arranged by the administrator, and the details used to create a new
Payment.
{{% gql-fields %}}
Add members to a Zone
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
Add an OptionGroup to a Product
{{% gql-fields %}}
Adjusts a draft OrderLine. If custom fields are defined on the OrderLine entity, a third argument 'customFields' of type OrderLineCustomFieldsInput will be available.
{{% gql-fields %}}
Applies the given coupon code to the draft Order
{{% gql-fields %}}
Assign assets to channel
{{% gql-fields %}}
Assigns Collections to the specified Channel
{{% gql-fields %}}
Assigns Facets to the specified Channel
{{% gql-fields %}}
Assigns PaymentMethods to the specified Channel
{{% gql-fields %}}
Assigns ProductVariants to the specified Channel
{{% gql-fields %}}
Assigns all ProductVariants of Product to the specified Channel
{{% gql-fields %}}
Assigns Promotions to the specified Channel
{{% gql-fields %}}
Assign a Role to an Administrator
{{% gql-fields %}}
Assigns ShippingMethods to the specified Channel
{{% gql-fields %}}
Assigns StockLocations to the specified Channel
{{% gql-fields %}}
Authenticates the user using a named authentication strategy
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
Create a new Administrator
{{% gql-fields %}}
Create a new Asset
{{% gql-fields %}}
Create a new Channel
{{% gql-fields %}}
Create a new Collection
{{% gql-fields %}}
Create a new Country
{{% gql-fields %}}
Create a new Customer. If a password is provided, a new User will also be created an linked to the Customer.
{{% gql-fields %}}
Create a new Address and associate it with the Customer specified by customerId
{{% gql-fields %}}
Create a new CustomerGroup
{{% gql-fields %}}
Creates a draft Order
{{% gql-fields %}}
Create a new Facet
{{% gql-fields %}}
Create one or more FacetValues
{{% gql-fields %}}
Create existing PaymentMethod
{{% gql-fields %}}
Create a new Product
{{% gql-fields %}}
Create a new ProductOption within a ProductOptionGroup
{{% gql-fields %}}
Create a new ProductOptionGroup
{{% gql-fields %}}
Create a set of ProductVariants based on the OptionGroups assigned to the given Product
{{% gql-fields %}}
{{% gql-fields %}}
Create a new Province
{{% gql-fields %}}
Create a new Role
{{% gql-fields %}}
Create a new Seller
{{% gql-fields %}}
Create a new ShippingMethod
{{% gql-fields %}}
{{% gql-fields %}}
Create a new Tag
{{% gql-fields %}}
Create a new TaxCategory
{{% gql-fields %}}
Create a new TaxRate
{{% gql-fields %}}
Create a new Zone
{{% gql-fields %}}
Delete an Administrator
{{% gql-fields %}}
Delete multiple Administrators
{{% gql-fields %}}
Delete an Asset
{{% gql-fields %}}
Delete multiple Assets
{{% gql-fields %}}
Delete a Channel
{{% gql-fields %}}
Delete multiple Channels
{{% gql-fields %}}
Delete a Collection and all of its descendants
{{% gql-fields %}}
Delete multiple Collections and all of their descendants
{{% gql-fields %}}
Delete multiple Countries
{{% gql-fields %}}
Delete a Country
{{% gql-fields %}}
Delete a Customer
{{% gql-fields %}}
Update an existing Address
{{% gql-fields %}}
Delete a CustomerGroup
{{% gql-fields %}}
Delete multiple CustomerGroups
{{% gql-fields %}}
{{% gql-fields %}}
Deletes Customers
{{% gql-fields %}}
Deletes a draft Order
{{% gql-fields %}}
Delete an existing Facet
{{% gql-fields %}}
Delete one or more FacetValues
{{% gql-fields %}}
Delete multiple existing Facets
{{% gql-fields %}}
{{% gql-fields %}}
Delete a PaymentMethod
{{% gql-fields %}}
Delete multiple PaymentMethods
{{% gql-fields %}}
Delete a Product
{{% gql-fields %}}
Delete a ProductOption
{{% gql-fields %}}
Delete a ProductVariant
{{% gql-fields %}}
Delete multiple ProductVariants
{{% gql-fields %}}
Delete multiple Products
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
Delete a Province
{{% gql-fields %}}
Delete an existing Role
{{% gql-fields %}}
Delete multiple Roles
{{% gql-fields %}}
Delete a Seller
{{% gql-fields %}}
Delete multiple Sellers
{{% gql-fields %}}
Delete a ShippingMethod
{{% gql-fields %}}
Delete multiple ShippingMethods
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
Delete an existing Tag
{{% gql-fields %}}
Deletes multiple TaxCategories
{{% gql-fields %}}
Deletes a TaxCategory
{{% gql-fields %}}
Delete a TaxRate
{{% gql-fields %}}
Delete multiple TaxRates
{{% gql-fields %}}
Delete a Zone
{{% gql-fields %}}
Delete a Zone
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
Authenticates the user using the native authentication strategy. This mutation is an alias for authenticate({ native: { ... }})
{{% gql-fields %}}
{{% gql-fields %}}
Allows an Order to be modified after it has been completed by the Customer. The Order must first
be in the Modifying state.
{{% gql-fields %}}
Move a Collection to a different parent or index
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
Removes Collections from the specified Channel
{{% gql-fields %}}
Removes the given coupon code from the draft Order
{{% gql-fields %}}
Remove Customers from a CustomerGroup
{{% gql-fields %}}
Remove an OrderLine from the draft Order
{{% gql-fields %}}
Removes Facets from the specified Channel
{{% gql-fields %}}
Remove members from a Zone
{{% gql-fields %}}
Remove an OptionGroup from a Product. If the OptionGroup is in use by any ProductVariants
the mutation will return a ProductOptionInUseError, and the OptionGroup will not be removed.
Setting the force argument to true will override this and remove the OptionGroup anyway,
as well as removing any of the group's options from the Product's ProductVariants.
{{% gql-fields %}}
Removes PaymentMethods from the specified Channel
{{% gql-fields %}}
Removes ProductVariants from the specified Channel
{{% gql-fields %}}
Removes all ProductVariants of Product from the specified Channel
{{% gql-fields %}}
Removes Promotions from the specified Channel
{{% gql-fields %}}
Remove all settled jobs in the given queues older than the given date. Returns the number of jobs deleted.
{{% gql-fields %}}
Removes ShippingMethods from the specified Channel
{{% gql-fields %}}
Removes StockLocations from the specified Channel
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
Sets the billing address for a draft Order
{{% gql-fields %}}
Allows any custom fields to be set for the active order
{{% gql-fields %}}
Sets the shipping address for a draft Order
{{% gql-fields %}}
Sets the shipping method by id, which can be obtained with the eligibleShippingMethodsForDraftOrder query
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
Update the active (currently logged-in) Administrator
{{% gql-fields %}}
Update an existing Administrator
{{% gql-fields %}}
Update an existing Asset
{{% gql-fields %}}
Update an existing Channel
{{% gql-fields %}}
Update an existing Collection
{{% gql-fields %}}
Update an existing Country
{{% gql-fields %}}
Update an existing Customer
{{% gql-fields %}}
Update an existing Address
{{% gql-fields %}}
Update an existing CustomerGroup
{{% gql-fields %}}
{{% gql-fields %}}
Update an existing Facet
{{% gql-fields %}}
Update one or more FacetValues
{{% gql-fields %}}
{{% gql-fields %}}
{{% gql-fields %}}
Update an existing PaymentMethod
{{% gql-fields %}}
Update an existing Product
{{% gql-fields %}}
Create a new ProductOption within a ProductOptionGroup
{{% gql-fields %}}
Update an existing ProductOptionGroup
{{% gql-fields %}}
Update existing ProductVariants
{{% gql-fields %}}
Update multiple existing Products
{{% gql-fields %}}
{{% gql-fields %}}
Update an existing Province
{{% gql-fields %}}
Update an existing Role
{{% gql-fields %}}
Update an existing Seller
{{% gql-fields %}}
Update an existing ShippingMethod
{{% gql-fields %}}
{{% gql-fields %}}
Update an existing Tag
{{% gql-fields %}}
Update an existing TaxCategory
{{% gql-fields %}}
Update an existing TaxRate
{{% gql-fields %}}
Update an existing Zone
{{% gql-fields %}}