---
title: New APIs for buyer-requested order edits - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/posts/new-apis-for-buyer-requested-order-edits'
  md: >-
    https://shopify.dev/changelog/posts/new-apis-for-buyer-requested-order-edits.md
metadata:
  effectiveApiVersion: 2026-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Events & webhooks
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-09-10T15:46:20-04:00'
  postedAt: '2026-10-01T00:00:00-04:00'
  updatedAt: '2026-10-05T15:23:34-04:00'
  effectiveAt: '2026-09-16T12:00:00-04:00'
---

October 1, 2026

# New APIs for buyer-requested order edits

DateOctober 1, 2026

Version[2026-10](https://shopify.dev/changelog?api_version=2026-10)

FlagsNew

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)[Events & webhooks](https://shopify.dev/changelog?api_type=webhook)

You can now manage buyer-requested order edits through the GraphQL Admin API, Customer Account API, and three new webhook topics in API version `2026-10`. Buyers can request the removal of unfulfilled line items from an order, and merchants (or apps acting on their behalf) can review, resolve, or decline those requests.

## What changed

Buyers can now request edits to the unfulfilled line items on an order, and those requests are exposed as a first-class resource, `RequestedOrderEdit`, across Shopify's APIs.

On the GraphQL Admin API:

* A new `RequestedOrderEdit` object represents a buyer's request, including its status, the requested changes, and timestamps for when the request was made, resolved, or declined.
* New mutations let apps act on requests on behalf of merchants and buyers: `requestedOrderEditCreate` creates a request, `requestedOrderEditResolve` marks a request as manually resolved, and `requestedOrderEditDecline` rejects a request.
* A new `requestedOrderEditCalculate` query returns the calculated financial outcome of a request before it's created.
* The Order object has a new `requestedOrderEdits` connection and a new `displayRequestedEditStatus` field that aggregates the order's request state for display. You can use the new `requested_order_edit_status` search filter on the orders query to find orders with requests waiting for merchant action.

On the Customer Account API, a new `orderRequestEdit` mutation lets buyers submit an edit request, and a new `requestedOrderEditCalculate` query previews the financial outcome. `orderRequestEdit` supports an optional idempotency key through the `@`idempotent directive. A retried request returns the originally created object instead of a duplicate.

Three new webhook topics notify apps as requests move through their lifecycle: `requested_order_edit/created`, `requested_order_edit/resolved`, and `requested_order_edit/declined`. The payload includes the request's status, the `order_id`, and the requested line item changes with their resolved quantities.

## Who's affected

Apps that read or manage orders, such as order management, ERP, fulfillment, and 3PL integrations, and apps that build customer account experiences. To use the new GraphQL Admin API surface, apps need the `read_orders` scope for queries and `write_orders` for mutations.

## Why this matters

In the `2026-07` API version, there is no API-visible record when a buyer wants an order changed after purchase. Buyers contact the merchant out-of-band, and merchants edit the order manually. Order edits made through requests flow through the existing order editing model, but apps can't see the request, act on it, or keep external systems (ERP, WMS) in sync with pending changes before fulfillment. With these APIs, apps can now surface pending requests in their own workflows, hold fulfillment on orders with a REQUESTED status, and automate resolution or decline decisions.

## What to do

No action is required. If you want to support buyer-requested order edits you can update your app to use the latest version of GraphQL Admin API, Customer Account API, and webhooks.

## Related docs

* [`RequestedOrderEdit` object reference](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/RequestedOrderEdit)
* [Admin API `requestedOrderEditCreate` mutation](https://shopify.dev/docs/api/admin-graphql/2026-10/mutations/requestedOrderEditCreate)
* [Customer API `orderRequestEdit` mutation](https://shopify.dev/docs/api/customer/2026-10/mutations/orderRequestEdit)
* [Webhook topics reference](https://shopify.dev/docs/api/webhooks/2026-10?reference=toml)