A job corresponds to some long running task that the client should poll for status.
This indicates if the job is still queued or has been run.
A globally-unique ID that's returned when running an asynchronous mutation.
This field will only resolve once the job is done. Can be used to ask for object(s) that have been changed by the job.
Returns a Job resource by ID. Used to check the status of internal jobs and any applicable changes.
Asynchronously adds a set of products to a given collection. It can take a long time to run. Instead of returning a collection, it returns a job which should be polled.
Removes a set of products from a given collection. The mutation can take a long time to run. Instead of returning an updated collection the mutation returns a job, which should be polled. For use with manual collections only.
Asynchronously reorders products within a specified collection. Instead of returning an updated collection, this mutation returns a job, which should be polled. The Collection.sortOrder must be MANUAL.
How to use this mutation:
moves list; do not send the entire product list. For example: to move the product at index 1 to index N, send a single move for that product with newPosition: N.newPosition is a zero-based index within the collection at the moment the move is applied (after any prior moves in the list).moves keep their relative order, aside from any displacement caused by the moves.newPosition is greater than or equal to the number of products, the product is placed at the end.Example:
Displaced products will have their position altered in a consistent manner with no gaps.
Updates a collection, modifying its properties, products, or publication settings. Collections help organize products together in the online store and other sales channels.
Use the collectionUpdate mutation to programmatically modify collections in scenarios such as:
There are two types of collections with different update capabilities:
job object that you can use to track the progress of the update.To publish or unpublish collections to specific sales channels, use the dedicated publishablePublish and publishableUnpublish mutations.
Learn more about using metafields with smart collections.
Enqueue the removal of a delivery profile.
Asynchronously delete automatic discounts in bulk if a search or saved_search_id argument is provided or if a maximum discount threshold is reached (1,000). Otherwise, deletions will occur inline. Warning: All automatic discounts will be deleted if a blank search argument is provided.
Activates multiple code discounts asynchronously using one of the following:
For example, you can activate discounts for all codes that match a search criteria, or activate a predefined set of discount codes.
Deactivates multiple code-based discounts asynchronously using one of the following:
For example, you can deactivate discounts for all codes that match a search criteria, or deactivate a predefined set of discount codes.
Deletes multiple code-based discounts asynchronously using one of the following:
For example, you can delete discounts for all codes that match a search criteria, or delete a predefined set of discount codes.
Asynchronously delete discount codes in bulk that customers can use to redeem a discount.
Adds tags to multiple draft orders.
Deletes multiple draft orders.
Removes tags from multiple draft orders.
Deletes all external marketing activities. Deletion is performed by a background job, as it may take a bit of time to complete if a large number of activities are to be deleted. Attempting to create or modify external activities before the job has completed will result in the create/update/upsert mutation returning an error.
Updates a metafield definition.
Asynchronously delete metaobjects and their associated metafields in bulk.
Cancels an order, with options for refunding, restocking inventory, and customer notification.
Order cancellation is irreversible. An order that has been cancelled can't be restored to its original state.
Use the orderCancel mutation to programmatically cancel orders in scenarios such as:
The orderCancel mutation provides flexible refund options including refunding to original payment methods or issuing store credit. If a payment was only authorized (temporarily held) but not yet charged, that hold will be automatically released when the order is cancelled, even if you choose not to refund other payments.
The mutation supports different cancellation reasons: customer requests, payment declines, fraud, inventory issues, staff errors, or other unspecified reasons. Each cancellation can include optional staff notes for internal documentation (notes aren't visible to customers).
An order can only be cancelled if it meets the following criteria:
Orders might be assigned to locations that become deactivated after the order was created. When cancelling such orders, inventory behavior depends on payment status:
After you cancel an order, you can still make limited updates to certain fields (like notes and tags) using the orderUpdate.
For partial refunds or more complex refund scenarios on active orders, such as refunding only specific line items while keeping the rest of the order fulfilled, consider using the refundCreate mutation instead of full order cancellation.
Learn how to build apps that integrate with order management and fulfillment processes.
Creates a payment for an order by mandate.
Duplicates a product.
If you need to duplicate a large product, such as one that has many variants that are active at several locations, you might encounter timeout errors.
To avoid these timeout errors, you can instead duplicate the product asynchronously.
In API version 2024-10 and higher, include synchronous: false argument in this mutation to perform the duplication asynchronously.
In API version 2024-07 and lower, use the asynchronous ProductDuplicateAsyncV2.
Metafield values are not duplicated if the unique values capability is enabled.
Asynchronously reorders the media attached to a product.
Create or update theme files.
Asynchronously delete redirects in bulk.
Asynchronously delete redirects in bulk.
Submits a UrlRedirectImport request to be processed.
The UrlRedirectImport request is first created with the urlRedirectImportCreate mutation.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4