---
title: >-
  Rerouting Fulfillment Orders is now possible via API - 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/rerouting-fulfillment-orders-via-api'
  md: 'https://shopify.dev/changelog/posts/rerouting-fulfillment-orders-via-api.md'
metadata:
  effectiveApiVersion: 2025-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-07-07T15:24:01-04:00'
  postedAt: '2025-10-01T12:00:00-04:00'
  updatedAt: '2025-07-09T11:21:41-04:00'
  effectiveAt: '2025-10-01T12:00:00-04:00'
---

October 1, 2025

# Rerouting Fulfillment Orders is now possible via API

DateOctober 1, 2025

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

FlagsNew

SurfacesAPI

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

We have introduced the `fulfillmentOrdersReroute` mutation to the Admin GraphQL API. This mutation allows you to move fulfillment orders to the next best location based on the shop’s delivery strategies. This update ensures that both the API and Admin offer the same capabilities, enhancing consistency and flexibility for developers.

With this mutation, you can optionally specify locations to exclude from the reroute. Alternatively, you can define a set of locations to consider for changing the fulfillment orders’ location.

```graphql
mutation {
  fulfillmentOrdersReroute(
    fulfillmentOrderIds: ["gid://shopify/FulfillmentOrder/12345678"],
    excludedLocationIds: ["gid://shopify/Location/456789"]
  ) {
    movedFulfillmentOrders {
      # FulfillmentOrder fields
    }
    userErrors {
      field
      message
    }
  }
}
```

For further details on working with the new mutation, please refer to our [documentation](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/fulfillmentOrdersReroute).