---
title: >-
  Order editing workflows now offer direct session access via mutation arguments
  and return fields - 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/order-editing-workflows-now-offer-direct-session-access-via-mutation-arguments-and-return-fields
  md: >-
    https://shopify.dev/changelog/order-editing-workflows-now-offer-direct-session-access-via-mutation-arguments-and-return-fields.md
metadata:
  effectiveApiVersion: 2025-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-06-16T11:30:34-04:00'
  postedAt: '2025-06-19T13:00:00-04:00'
  updatedAt: '2025-06-18T14:05:00-04:00'
  effectiveAt: '2025-06-17T12:00:00-04:00'
---

June 19, 2025

Tags:

* Admin GraphQL API
* 2025-10

# Order editing workflows now offer direct session access via mutation arguments and return fields

In API version 2025-10, we've enhanced order editing workflows, making them more flexible and improving traceability features. These updates expand mutation ID compatibility and add session details to return fields, making it easier to track and manage order editing sessions.

## What's New

### Direct order edit session access

Now, you can directly access order edit sessions through the `id` field on the [OrderEditSession](https://shopify.dev/docs/api/admin-graphql/2025-10/objects/OrderEditSession) object, enhancing the tracking of changes throughout your order editing workflow.

### Enhanced mutation ID flexibility

Order editing mutations now accept IDs from both [`CalculatedOrder`](https://shopify.dev/docs/api/admin-graphql/2025-10/objects/CalculatedOrder) and [`OrderEditSession`](https://shopify.dev/docs/api/admin-graphql/2025-10/objects/OrderEditSession) objects. This enhancement provides greater flexibility in your application architecture by supporting different workflows based on session context.

**Affected mutations:**

* [`OrderEditAddCustomItem`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditUpdateShippingLine)
* [`OrderEditAddLineItemDiscount`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditAddLineItemDiscount)
* [`OrderEditAddShippingLine`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditAddShippingLine)
* [`OrderEditAddVariant`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditAddVariant)
* [`OrderEditCommit`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditCommit)
* [`OrderEditRemoveDiscount`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditRemoveDiscount)
* [`OrderEditRemoveShippingLine`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditRemoveShippingLine)
* [`OrderEditRemoveLineItemDiscount`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditRemoveLineItemDiscount)
* [`OrderEditSetQuantity`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditSetQuantity)
* [`OrderEditUpdateDiscount`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditUpdateDiscount)
* [`OrderEditUpdateShippingLine`](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditUpdateShippingLine)

### Expanded return fields

Order editing mutations now return an `orderEditSession` field, enabling you to use the session `id` in subsequent mutation calls for improved workflow continuity. This enhancement applies to all mutations listed above, plus:

* [OrderEditBegin](https://shopify.dev/docs/api/admin-graphql/2025-10/mutations/orderEditBegin)

These improvements provide a more flexible approach to managing order editing workflows while maintaining full traceability of session changes.