Update a cargo lot

put/caravans/{caravanId}/manifest/lots/{lotId}

Replaces the details of an existing cargo lot on the manifest.

Path Parameters

caravanIdstringrequired

lotIdstringrequired

Request Body

required

application/json

commoditystring

descriptionstring

statusstring ("pending" | "weighed" | "sealed" | "loaded")

weight_kgnumber (float)

declared_valuenumber (float)

Responses

200OK

application/json

idstringrequired

commoditystringrequired

Cargo category

descriptionstring

Handling guidance for this cargo lot

statusstring ("pending" | "weighed" | "sealed" | "loaded")required

quantityinteger

Count of packages, crates, bolts, jars, or bundles in the lot

Unit used to count this cargo lot

weight_kgnumber (float)

Total lot weight in kilograms

declared_valuenumber (float)

Declared value in trading dinars

origin_stallstring

Stall or warehouse where the cargo lot originated

inspection_statusstring ("not_required" | "pending" | "passed" | "held")

Current inspection result for the lot

Errors

Request

curl -X PUT 'https://api.cameltrading.example/v1/caravans/car_sahara_001/manifest/lots/lot_spice_042' \
  -H 'Authorization: Bearer <your-token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "commodity": "Saffron Threads",
  "description": "Lot resealed after inspection by the master trader",
  "status": "sealed",
  "weight_kg": 38.2,
  "declared_value": 1265
}'

Response

{
  "id": "lot_spice_042",
  "commodity": "Saffron",
  "category": "spice",
  "description": "Keep sealed in waxed linen and away from direct sun",
  "status": "weighed",
  "quantity": 12,
  "unit": "jar",
  "weight_kg": 38.5,
  "declared_value": 1240.75,
  "origin_stall": "Spice Vault 3",
  "inspection_status": "passed"
}