---
title: "Update Return Status"
method: PUT
path: "/returns/{returnId}/status"
tags: ["Returns"]
---

# Update Return Status

`PUT /returns/{returnId}/status`

Update return status.

Certain status transitions trigger additional side effects to maintain data consistency:

- Setting status to **complete** will also mark all return items as complete.
- Setting status to **open** from **complete** or **rejected** will reopen the return, resetting all processed/rejected items back to open, clearing pending processing info, resetting the expiration date, and marking the return as reopened. **Note:** Reopening a processed return does not reverse any refunds, exchanges, or other actions that were performed during processing.

Requires the [`returns_write`](/docs/api-reference/scopes) scope.

## Path parameters

- `returnId` string, required

## Request body

- object
  - `status` 'complete' | 'open' | 'flagged' | 'rejected' | 'deleted', required — Return status. * complete: The return has been completed successfully. * open: Return has been approved and is awaiting shipment. * flagged: A problem with return processing requires merchant action. * rejected: The return has been rejected. * deleted: The return has been reset.

## Response `204`

Updated

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/redoapp/apis/redo-api.md) · [All operations](https://skmtc.dev/redoapp/apis/redo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redoapp/redo-api/revisions/119714540a45/schema)