---
title: orderRequestEdit - Customer API
description: >-
  Request an edit to an order's unfulfilled line items on behalf of a customer.


  > Note:

  > This mutation supports an optional idempotency key via the `@idempotent`
  directive.

  > Supplying the same key for a retried request returns the originally created

  > edit instead of creating a duplicate.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/mutations/orderRequestEdit'
  md: 'https://shopify.dev/docs/api/customer/latest/mutations/orderRequestEdit.md'
api_name: customer
api_type: graphql
type: mutation
---

# order​Request​Edit

mutation

Requires `customer_write_pre_authenticated` access scope. Also: The user must have customer\_write\_orders access or be pre-authenticated for the queried order.

Request an edit to an order's unfulfilled line items on behalf of a customer.

***

**Note:** This mutation supports an optional idempotency key via the \<code>@idempotent\</code> directive. Supplying the same key for a retried request returns the originally created edit instead of creating a duplicate.

***

## Arguments

* email

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The email address to associate with the order if one doesn't exist.

* line​Items

  [Requested​Order​Edit​Line​Items​Input!](https://shopify.dev/docs/api/customer/latest/input-objects/RequestedOrderEditLineItemsInput)

  required

  The line item changes requested for the order, grouped by the type of change.

* order​Id

  [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

  required

  The ID of the order for which this edit is being requested.

***

## Order​Request​Edit​Payload returns

* requested​Order​Edit

  [Requested​Order​Edit](https://shopify.dev/docs/api/customer/latest/objects/RequestedOrderEdit)

  The created requested order edit.

* user​Errors

  [\[Requested​Order​Edit​User​Error!\]!](https://shopify.dev/docs/api/customer/latest/objects/RequestedOrderEditUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### orderRequestEdit reference