> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eazecustoms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a HAWB

> Update house air waybill number, package count, or gross weight.

Update a HAWB. Totals must not exceed the shipment.

### Path Parameters

<ParamField path="id" type="string" required>
  Shipment Public ID (`shp_…`).
</ParamField>

<ParamField path="hawbId" type="string" required>
  HAWB Public ID (`hawb_…`).
</ParamField>

### Body

<ParamField body="houseAirWaybillNumber" type="string">
  Updated house air waybill number.
</ParamField>

<ParamField body="packageCount" type="integer">
  Updated package count.
</ParamField>

<ParamField body="grossWeightKg" type="number">
  Updated gross weight in kilograms.
</ParamField>

```json JSON Payload theme={null}
{
  "packageCount": 5,
  "grossWeightKg": 45
}
```

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "hawbId": "hawb_3f9a1c0e5b7d4e2f8a6c1b9d0e3f7a25",
    "shipmentId": "shp_3f9a1c0e5b7d4e2f8a6c1b9d0e3f7a25",
    "houseAirWaybillNumber": "HWB-101",
    "packageCount": 5,
    "grossWeightKg": 45,
    "status": "NOT_INITIATED",
    "isActive": true,
    "reportedStock": { "packageCount": 0, "grossWeightKg": 0 },
    "remainingStock": { "packageCount": 5, "grossWeightKg": 45 },
    "createdAt": "2026-06-10T08:30:00.000Z",
    "updatedAt": "2026-06-10T09:00:00.000Z"
  }
  ```
</ResponseExample>