---
title: RequestedOrderEdit - Customer API
description: A requested order edit on an order.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/objects/RequestedOrderEdit'
  md: 'https://shopify.dev/docs/api/customer/latest/objects/RequestedOrderEdit.md'
api_name: customer
api_type: graphql
type: object
---

# Requested​Order​Edit

object

Requires `customer_read_orders` access scope.

A requested order edit on an order.

## Fields

* id

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

  non-null

  A globally-unique ID.

* line​Items

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

  non-null

  The line item changes included in the requested order edit, grouped by the type of change.

* status

  [Requested​Order​Edit​Status!](https://shopify.dev/docs/api/customer/latest/enums/RequestedOrderEditStatus)

  non-null

  The status of this requested order edit.

***

## Map

### Fields and connections with this object

* [Order.requestedOrderEdits](https://shopify.dev/docs/api/customer/latest/objects/Order#field-Order.fields.requestedOrderEdits)
* [RequestedOrderEditConnection.nodes](https://shopify.dev/docs/api/customer/latest/connections/RequestedOrderEditConnection#returns-nodes)
* [RequestedOrderEditEdge.node](https://shopify.dev/docs/api/customer/latest/objects/RequestedOrderEditEdge#field-RequestedOrderEditEdge.fields.node)

***

## Mutations

* [order​Request​Edit](https://shopify.dev/docs/api/customer/latest/mutations/orderRequestEdit)

  mutation

  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.

  ***

  * email

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

    ### Arguments

    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.

  ***

***

## RequestedOrderEdit Mutations

### Mutated by

* [order​Request​Edit](https://shopify.dev/docs/api/customer/latest/mutations/orderRequestEdit)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)

  interface

***

## RequestedOrderEdit Implements

### Implements

* [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)