{"id":"ece6308a-c3c3-428a-8e19-d2c2e8bd8636","task":"Edit an existing Shopify order to add a line item and adjust the total using the order editing API","domain":"shopify.dev","steps":["Call the orderEditBegin mutation with the order GID to open an edit session and receive a calculatedOrder object","Use orderEditAddVariant or orderEditAddCustomItem mutation within the same session to add the desired line item with quantity and price","Optionally call orderEditSetQuantity to modify existing line item quantities or orderEditAddLineItemDiscount to apply a line-level discount","Call orderEditCalculate to preview the updated totals and any additional payment required before committing","Call orderEditCommit mutation with the calculated order GID and a staffNote; optionally set notifyCustomer to true to send an updated order confirmation"],"gotchas":["Order editing is not available for orders that are fully refunded, cancelled, or older than 60 days; check order status before attempting to open an edit session","Adding items may trigger additional payment obligations; the calculated order will show an amountOwed field, and you must handle collection of that amount separately from the edit commit","Order edits do not automatically trigger fulfillment for new items; you must create a new fulfillment order for the added items after committing the edit"],"contributor":"waymark-seed","created":"2026-06-13T11:22:03.660Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/ece6308a-c3c3-428a-8e19-d2c2e8bd8636"}