Update Status

Moves an RMA request to a new status. Pass a status id taken from the request's availableStatuses (see Get Return).

Endpoint

Endpoint	Method
/api/admin/rma/requests/{id}/update-status	POST

Action semantics

Two statuses do more than change the label:

• Received package (rma_status_id = 5) — creates a refund for the returned item. Send a shipping amount to include shipping in the refund; omit or send 0 to refund the item only.
• Item canceled (rma_status_id = 8) — cancels the order item and restores its inventory.

Any other status just updates the status. Every status change adds a note to the conversation and notifies the customer.

Request Body

Field	Type	Required	Description
rma_status_id	integer	yes	The next status id (one of the request's availableStatuses).
shipping	number	no	Shipping amount to include when the status creates a refund. Defaults to 0.

Permission

sales.rma.requests

TIP

See the Returns overview for the full status workflow.

All admin endpoints require an admin Bearer token — see Authentication.