# Medusa Exchanges API

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

Medusa Exchanges 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 Exchanges. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

An exchange is the replacement of an item that the customer ordered with another. These API routes allow admin users to create and manage exchanges.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/admin/exchanges` | List Exchanges |
| POST | `/admin/exchanges` | Create Exchange |
| GET | `/admin/exchanges/{id}` | Get an Exchange |
| POST | `/admin/exchanges/{id}/cancel` | Cancel an Exchange |
| POST | `/admin/exchanges/{id}/inbound/items` | Add Inbound Items to an Exchange |
| POST | `/admin/exchanges/{id}/inbound/items/{action_id}` | Update an Inbount Item of an Exchange |
| DELETE | `/admin/exchanges/{id}/inbound/items/{action_id}` | Remove Inbound Item from Exchange |
| POST | `/admin/exchanges/{id}/inbound/shipping-method` | Add an Inbound Shipping Method to an Exchange |
| POST | `/admin/exchanges/{id}/inbound/shipping-method/{action_id}` | Update Inbound Shipping Method of an Exchange |
| DELETE | `/admin/exchanges/{id}/inbound/shipping-method/{action_id}` | Remove Inbound Shipping Method from Exchange |
| POST | `/admin/exchanges/{id}/outbound/items` | Add Outbound Items to Exchange |
| POST | `/admin/exchanges/{id}/outbound/items/{action_id}` | Update Outbound Item of an Exchange |
| DELETE | `/admin/exchanges/{id}/outbound/items/{action_id}` | Remove Outbound Item from Exchange |
| POST | `/admin/exchanges/{id}/outbound/shipping-method` | Add Outbound Shipping Method to Exchange |
| POST | `/admin/exchanges/{id}/outbound/shipping-method/{action_id}` | Update Outbound Shipping Method of Exchange |
| DELETE | `/admin/exchanges/{id}/outbound/shipping-method/{action_id}` | Remove Outbound Shipping Method from Exchange |
| POST | `/admin/exchanges/{id}/request` | Confirm an Exchange |
| DELETE | `/admin/exchanges/{id}/request` | Cancel Exchange Request |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/medusa/refs/heads/main/openapi/medusa-exchanges-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

Exchanges

---

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