---
title: "Update order"
method: POST
path: "/seller/orders/{id}"
tags: ["seller-orders"]
---

# Update order

`POST /seller/orders/{id}`

Apply a seller action to an order (for example shipping or dispute actions).

Use this endpoint to progress fulfillment or open item-level disputes from seller tools.

Behavior:
- Validates order ownership against the authenticated seller.
- Applies order-item updates through the shared order update engine.
- Supports structured action payloads (including shipment metadata when required).

Responses:
- Returns `204` on success.
- Returns `404` if the order cannot be found for the seller.

## Path parameters

- `id` string, required — Order ID

## Request body

- union — Update actions that can be performed by a seller
  - object
    - `action` 'accept', required
    - `items` object[], required — Items to accept
      - `id` string, required
      - `quantity` integer, required
  - object
    - `action` 'ship', required
    - `shipment` object, required — Shipment details including tracking number and carrier
      - `trackingNumber` string, required
      - `carrier` 'Royal Mail' | 'Evri' | 'DHL Express' | 'DPD UK' | 'UPS' | 'Parcelforce' | 'FedEx', required — Supported carriers for EasyPost tracking
    - `items` object[], required — Items to ship
      - `id` string, required
      - `quantity` integer, required
  - object
    - `action` 'dispute', required
    - `items` object[], required — Items to dispute
      - `id` string, required
      - `quantity` integer, required
    - `case` object, required
      - `reason` 'SNAD' | 'DAMAGED' | 'WRONG_ITEM' | 'NOT_RECEIVED' | 'OTHER' | 'CHARGEBACK', required
      - `comment` string
      - `outcomes` union[], required — Proposed outcomes
        - union
          - object
            - `type` 'RETURN', required
            - `address` object, required
              - …
            - `amount` integer, required
            - `comment` string
          - object
            - `type` 'REFUND', required
            - `amount` integer, required
            - `comment` string
          - object
            - `type` 'REPLACEMENT', required
            - `comment` string

## Response `204`

Order updated

## Other responses

- `404` — Order not found

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/e8d78a3a2e8b/schema)