---
title: "Update Status"
method: PUT
path: "/v4/shipments/status"
tags: ["Shipments"]
---

# Update Status

`PUT /v4/shipments/status`

**Hold** - Put the shipments on hold for up to 28 days. Shipments on hold for longer than 28 days will be cancelled. A shipment on hold will not be included in an closeouts/manifests, but instead will remain in its current state. You can only put shipments on hold that are in the 'LabelPrinted' status as only shipments with this status are included in manifests.
<br />            
<br />**Cancel** - Use to cancel/void one or more current shipments. This can only be used before a shipment has been confirmed by being manifested.
<br />            
<br />**Release** - Use to release shipments from hold and shipments cancelled for less than 24 hours. Once released, the shipment will be included in the next manifest.
<br />            
<br />**Picked** - Set the shipment to picked. This means this shipment will only be manifested if you choose to manifest 'Picked' shipments.

## Request body

- UpdateStatusRequest — Update Status Request
  - `Status` 'Hold' | 'Cancel' | 'Release' | 'Picked', required — Update Status Type <br /> <br />**Hold** - Put the shipments on hold for up to 28 days. Shipments on hold for longer than 28 days will be cancelled. A shipment on hold will not be included in an closeouts/manifests, but instead will remain in its current state. You can only put shipments on hold that are in the 'LabelPrinted' status as only shipments with this status are included in manifests. <br />**Cancel** - Use to cancel/void one or more current shipments. This can only be used before a shipment has been confirmed by being manifested. <br />**Release** - Use to release shipments from hold and shipments cancelled for less than 24 hours. Once released, the shipment will be included in the next manifest. <br />**Picked** - Set the shipment to picked. This means this shipment will only be manifested if you choose to manifest 'Picked' shipments.
  - `Reason` string, nullable — Reason <br />The reason for this status update. <br /> <br />If the status you are updating to is 'Hold' the reason is required and must be one of the following values: <br />**Awaiting Dispatch** <br />**Awaiting Payment** <br />**Awaiting Stock** <br />**Awaiting Customer Response** <br />**Held for Shipping Day** <br />**Weight Consolidation** <br />**Warehouse Processing** <br /> <br />If the status you are updating to is 'Cancel', the reason is required and must be one of the following values: <br />**Order Cancelled** <br />**Packed in Error** <br />**Repacked**
  - `ShipmentIds` string[], required — Shipment Ids <br />The shipments to apply the change to. <br />There must be at least 1 shipment and a maximum of 99. <br /> <br />The Shipment Id may be an id or a tracking/barcode number. <br />For consignment shipments, only the consignment level tracking/barcode number can be used.

## Response `200`

All shipments were updated successfully.

## Other responses

- `400` — Invalid request response.
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/intersoftsapient/apis/sapient-core-api.md) · [All operations](https://skmtc.dev/intersoftsapient/apis/sapient-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intersoftsapient/sapient-core-api/revisions/3315ad0b5875/schema)