---
title: >-
  Improved user errors on the fulfillmentOrderCancel mutation - 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/fulfillment-order-cancel-error-codes'
  md: 'https://shopify.dev/changelog/posts/fulfillment-order-cancel-error-codes.md'
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-12-08T06:13:56-05:00'
  postedAt: '2026-04-01T12:00:00-04:00'
  updatedAt: '2025-12-18T01:02:27-05:00'
  effectiveAt: '2025-04-01T12:00:00-04:00'
---

April 1, 2026

# Improved user errors on the `fulfillmentOrderCancel` mutation

DateApril 1, 2026

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

FlagsUpdate

SurfacesAPI

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

The `fulfillmentOrderCancel` mutation now returns a specific `fulfillmentOrderCancelError` type instead of the generic `userError` type.

## What's changing:

The error response now includes a code field for easier programmatic error handling and identification.

## Why we made this change:

This enhancement supports the new feature for manually marking fulfillment orders as in-progress, which allows merchants to self-report progress on their fulfillment orders. As part of this feature, cancelling fulfillment orders with reported progress is now restricted, and the enhanced error responses help developers handle these restrictions more effectively.