Update a shipment

Change customer, addresses, and weight while the shipment is unpaid.

PATCH /shipments/{shipment}

Update a shipment

cURL

curl --request PATCH \
  --url https://api.kasiye.com/v1/shipments/{shipment} \
  --header 'Authorization: Bearer <token>'

Allowed only while status is pending and payment_status is awaiting_payment. Kasiye recalculates the quote. If the new route is not covered, the shipment is left unchanged and the API returns 422.

The request body is the same as create.

path.shipment · string · required

Shipment reference, for example SHP-12345.

curl -X PATCH https://api.kasiye.com/v1/shipments/SHP-12345 \
  -H "Authorization: Bearer shp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_name": "Acme Corp",
    "customer_email": "[e-mail]",
    "pickup_address": "Area 47, Lilongwe",
    "pickup_lat": -13.9626,
    "pickup_lng": 33.7741,
    "dropoff_address": "City Centre, Lilongwe",
    "dropoff_lat": -13.9833,
    "dropoff_lng": 33.7689,
    "weight_kg": 40
  }'

After payment, update returns 422:

{
  "message": "This shipment can no longer be updated.",
  "errors": {
    "shipment": ["This shipment can no longer be updated."]
  }
}