---
title: "Updates parcel state"
method: PATCH
path: "/api/v{version}/parcels/{parcelId}/state"
tags: ["orders"]
---

# Updates parcel state

`PATCH /api/v{version}/parcels/{parcelId}/state`

Updates parcel state. Permissions requises : HubParcelsManagerRole, HubAdminRole, SupplierAdminRole, SupplierParcelsManagerRole.

## Path parameters

- `version` string, required
- `parcelId` string, uuid, required

## Headers

- `X-Tenant` string, required

## Request body

- UpdateParcelStateRequest
  - `parcelId` string, uuid
  - `newStateId` string, uuid
  - `deliveryPersonId` string, uuid, nullable
  - `arrivalHubId` string, uuid, nullable
  - `comment` string, nullable

## Response `200`

OK

- UpdateParcelStateResponse
  - `parcelId` string, uuid
  - `newStateId` string, uuid
  - `newStateName` string, nullable
  - `trackingNumber` string, nullable

---

[API](https://skmtc.net/zrexpress/apis/zrexpress-api.md) · [All operations](https://skmtc.net/zrexpress/apis/zrexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zrexpress/zrexpress-api/versions/99b075e0b641/schema)