---
title: "Update purchase order"
method: POST
path: "/user/purchases/{id}/{orderId}"
tags: ["user-purchases"]
---

# Update purchase order

`POST /user/purchases/{id}/{orderId}`

Apply a buyer-side update to a specific order inside a purchase.

Use this endpoint for post-purchase item actions such as delivery confirmation or opening a dispute.

Rules:
- Purchase must belong to the authenticated user.
- Target `orderId` must exist within that purchase.
- Cancellation is intentionally excluded from this endpoint and handled by the dedicated cancel route.

Responses:
- Returns `204` on success.
- Returns `404` for missing purchase or order.

## Path parameters

- `id` string, required — Purchase ID
- `orderId` string, required — Order ID

## Request body

- union — Customer-initiated order updates. Use the separate cancel endpoint to cancel a purchase.
  - object
    - `action` 'delivered', required
    - `items` object[], required — Items to mark as delivered
      - `id` string, 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
            - `comment` string
            - `amount` integer, required
          - object
            - `type` 'REFUND', required
            - `comment` string
            - `amount` integer, required
          - object
            - `type` 'REPLACEMENT', required
            - `comment` string
          - 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` — Purchase or 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/5ed45d6a9e2f/schema)