# Medusa Order Edits API

**Canonical:** https://apis.io/apis/medusa/medusa-order-edits-api/  
**Provider:** Medusa — https://apis.io/providers/medusa/  
**Base URL:** https://{medusa-backend-domain}  
**Documentation:** https://docs.medusajs.com/api/store

Medusa Order Edits API is one of 82 APIs that [Medusa](https://apis.io/providers/medusa/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Order Edits. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

An order edit is a change to an order's details, such as items, shipping methods, and more. Changes made by an order edit are only applied on the order once they're confirmed. The order's previous version is retained due to versioning. These API routes allow admin users to make edits to an order and manage those edits.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| POST | `/admin/order-edits` | Create Order Edit |
| DELETE | `/admin/order-edits/{id}` | Cancel Order Edit |
| POST | `/admin/order-edits/{id}/confirm` | Confirm Order Edit |
| POST | `/admin/order-edits/{id}/items` | Add Items to Order Edit |
| POST | `/admin/order-edits/{id}/items/item/{item_id}` | Update Order Item Quantity of Order Edit |
| POST | `/admin/order-edits/{id}/items/{action_id}` | Update an Item in an Order Edit |
| DELETE | `/admin/order-edits/{id}/items/{action_id}` | Remove Item from Order Edit |
| POST | `/admin/order-edits/{id}/request` | Request Order Edit |
| POST | `/admin/order-edits/{id}/shipping-method` | Add Shipping Method to Order Edit |
| POST | `/admin/order-edits/{id}/shipping-method/{action_id}` | Update Shipping Method of an Order Edit |
| DELETE | `/admin/order-edits/{id}/shipping-method/{action_id}` | Remove Shipping Method from Order Edit |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/medusa/refs/heads/main/openapi/medusa-order-edits-api-openapi.yml
- **Documentation** — https://docs.medusajs.com/api/store
- **APIReference** — https://docs.medusajs.com/api/store
- **OpenAPI Source** — https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yaml
- **Authentication** — https://docs.medusajs.com/api/store#authentication
- **Documentation** — https://docs.medusajs.com/api/admin
- **APIReference** — https://docs.medusajs.com/api/admin
- **OpenAPI Source** — https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/admin/openapi.full.yaml
- **Authentication** — https://docs.medusajs.com/api/admin#authentication

## Other Medusa APIs (12)

- [Medusa GraphQL API](https://apis.io/apis/medusa/medusa-graphql-api/)
- [Medusa MCP Remote Server](https://apis.io/apis/medusa/medusa-mcp-server/)
- [Medusa Api Keys API](https://apis.io/apis/medusa/medusa-api-keys-api/)
- [Medusa Auth API](https://apis.io/apis/medusa/medusa-auth-api/)
- [Medusa [auth Provider] API](https://apis.io/apis/medusa/medusa-auth-provider-api/)
- [Medusa Campaigns API](https://apis.io/apis/medusa/medusa-campaigns-api/)
- [Medusa Carts API](https://apis.io/apis/medusa/medusa-carts-api/)
- [Medusa Claims API](https://apis.io/apis/medusa/medusa-claims-api/)
- [Medusa Collections API](https://apis.io/apis/medusa/medusa-collections-api/)
- [Medusa Currencies API](https://apis.io/apis/medusa/medusa-currencies-api/)
- [Medusa Customer Groups API](https://apis.io/apis/medusa/medusa-customer-groups-api/)
- [Medusa Customers API](https://apis.io/apis/medusa/medusa-customers-api/)

## Tags

Order Edits

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/medusa/medusa-order-edits-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/medusa/.