Skip to main content
PATCH
/
v1
/
shipments
/
{id}
Update Shipment
curl --request PATCH \
  --url https://api.wizcommerce.com/v1/shipments/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "Standard Delivery",
  "shipment_items": [
    {
      "product_id": "SKU-001",
      "quantity": 2
    }
  ],
  "id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
  "order_id": "ORD-2024-001",
  "status": "active",
  "shipment_status": "shipped",
  "tracking_info": {
    "tracking_number": "1Z999AA10123456784",
    "tracking_url": "https://tracking.carrier.com/1Z999AA10123456784",
    "delivery_partner": "FedEx"
  },
  "updated_at": "2024-03-10T14:30:00Z",
  "remark": "Door to Door",
  "note": "Handle with care"
}
'
{
  "data": {
    "id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
    "shipment_items": [
      {
        "id": "123",
        "sku_id": "123",
        "quantity": 10
      }
    ],
    "reference_id": "123",
    "order_id": "123",
    "status": "shipped",
    "tracking_info": {
      "tracking_number": "123",
      "tracking_url": "https://www.google.com",
      "delivery_partner": "Fedex"
    },
    "created_at": "2021-01-01T00:00:00Z",
    "updated_at": "2021-01-01T00:00:00Z",
    "note": "Handle with care"
  }
}
The PATCH request is used to partially update an existing entity by the given id. This means:
  • Only the fields provided in the request body will be updated.
  • Fields not provided in the request body will remain unchanged.
  • The request is idempotent, meaning multiple identical PATCH requests will always result in the same final state.

Authorizations

​
X-API-Key
string
header
required

API Key for authentication

Path Parameters

​
id
string
required

Shipment ID

Body

application/json

Shipment

​
name
string
Maximum string length: 255
Example:

"Standard Delivery"

​
shipment_items
object[]

If the key is passed as [], the items will be removed.

​
id
string
Maximum string length: 255
Example:

"01f5d171-d3e3-4b2b-bd57-0727194b5bed"

​
order_id
string
Maximum string length: 255
Example:

"ORD-2024-001"

​
status
enum<string>
default:active
Available options:
active,
inactive
Example:

"active"

​
shipment_status
enum<string>
Available options:
shipped,
created
Example:

"shipped"

​
tracking_info
object
​
updated_at
string
Example:

"2024-03-10T14:30:00Z"

​
remark
string
Maximum string length: 255
Example:

"Door to Door"

​
note
string
Example:

"Handle with care"

Response

Created

​
data
object