---
title: "Update case"
method: PUT
path: "/seller/cases/{id}"
tags: ["seller-cases"]
---

# Update case

`PUT /seller/cases/{id}`

Apply a seller action to an existing case.

Use this endpoint for case workflow actions like accepting/rejecting outcomes or escalating.

Rules:
- Seller must own the order associated with the case.
- Returns `404` for missing/non-owned cases.
- Returns `409` when an outcome has already been accepted and cannot be changed.

Side effects:
- Escalation actions trigger case update notifications.
- Returns the refreshed case representation after mutation.

## Path parameters

- `id` string, required — Case ID

## Request body

- union
  - object
    - `action` 'escalate', required
  - object
    - `action` 'outcome', required
    - `outcome` union, required
      - object
        - `type` 'RETURN', required
        - `address` object, required
          - `city` string, nullable
          - `country` string, nullable
          - `line1` string, nullable
          - `line2` string, nullable
          - `postal_code` string, nullable
          - `state` string, nullable
        - `amount` integer, required
        - `comment` string
      - object
        - `type` 'REFUND', required
        - `amount` integer, required
        - `comment` string
      - object
        - `type` 'REPLACEMENT', required
        - `comment` string
  - object
    - `action` 'accept', required
    - `outcome` union, required
      - object
        - `type` 'RETURN', required
        - `id` string, cuid2, required
        - `address` object, required
          - `city` string, nullable
          - `country` string, nullable
          - `line1` string, nullable
          - `line2` string, nullable
          - `postal_code` string, nullable
          - `state` string, nullable
      - object
        - `type` 'REFUND', required
        - `id` string, cuid2, required
      - object
        - `type` 'REPLACEMENT', required
        - `id` string, cuid2, required
  - object
    - `action` 'reject', required
    - `outcome` object, required
      - `type` 'RETURN' | 'REFUND' | 'REPLACEMENT', required
      - `id` string, cuid2, required
  - object
    - `action` 'resolve', required
    - `outcome` object, required
      - `type` 'RETURN', required
      - `id` string, cuid2, required

## Response `200`

Updated case

- UpdatedSellerCase
  - `id` string, cuid2, required
  - `workflowId` string, required
  - `reason` 'SNAD' | 'DAMAGED' | 'WRONG_ITEM' | 'NOT_RECEIVED' | 'OTHER' | 'CHARGEBACK', required
  - `comment` string, nullable
  - `status` 'OPEN' | 'REMEDIATION' | 'SETTLED' | 'CLOSED' | 'ESCALATED', required
  - `createdAt` string, date-time, nullable, required
  - `updatedAt` string, date-time, nullable, required
  - `outcomes` object[], required
    - `id` string, cuid2, required
    - `type` 'RETURN' | 'REFUND' | 'REPLACEMENT', required
    - `party` 'SELLER' | 'BUYER' | 'SYSTEM', required
    - `status` 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'RESOLVED', required
    - `caseId` string, cuid2, required
    - `amount` integer, required
    - `comment` string, nullable
    - `createdAt` string, date-time, nullable, required
    - `updatedAt` string, date-time, nullable, required
    - `deliveryAddress` unknown
  - `attachments` object[], required
    - `url` string, uri, required
    - `party` 'SELLER' | 'BUYER' | 'SYSTEM', required
    - `createdAt` union, required
      - string, date-time
      - string, date-time
  - `orderId` string, required

## Other responses

- `404` — Case not found
- `409` — Outcome already accepted

---

[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/6367b514f6ea/schema)