Update a consignment

patch

/consignments/{consignmentId}

updateConsignment

The one FLAT body in this document, and deliberately so: every other request body here carries an array or a map, which the try-it client cannot draw as a form. Without this endpoint the form view — and the toggle between it and the JSON editor — would never render on this site, and a view nothing renders is a view whose failures nobody sees. Four properties, one of each kind of box: text, enum, boolean, number.

Autorização

Qualquer um destes
- apiKeyapiKey · X-Api-Key · Cabeçalho
  A key from the account page.
Qualquer um destes
- bearerhttp · bearer
  A token obtained from the authorisation server.

Parâmetros

Caminho

consignmentId*Obrigatóriostring

Corpo do pedido Obrigatório

application/json

objectConsignmentPatchThe fields of a consignment that may be changed after booking.

referencestringcomprimento mín 1comprimento máx 120
statusstringbooked | loading | sailing | landed | cancelled
insuredbooleanWhether the load is covered.
priorityintegermín 1máx 100How far up a berth queue this consignment sorts.

json

{
  "reference": "string",
  "status": "booked",
  "insured": true,
  "priority": 1
}

Respostas

200

The consignment as it now stands.

application/json

objectConsignmentOne consignment, as the API sees it.

id*ObrigatóriostringApenas leitura
reference*Obrigatóriostringcomprimento mín 1comprimento máx 120
status*ObrigatóriostringConsignmentStatusbooked | loading | sailing | landed | cancelledWhere a consignment has got to.
createdAtstringApenas leitura
parentanyConsignmentRefere-se a si próprio; expandido acima.
tagsarray<string>únicos
Cada elemento
string
metadataobject
Qualquer outra propriedade
string

json

{
  "id": "00000000-0000-4000-8000-000000000000",
  "reference": "string",
  "status": "booked",
  "createdAt": "2026-01-01T09:00:00Z",
  "parent": null,
  "tags": [
    "string"
  ],
  "metadata": {}
}

404

Something went wrong, described the same way every time.

application/problem+json

objectProblem

title*ObrigatóriostringA short, human-readable summary.
status*Obrigatóriointegermín 400máx 599
detailstring | null

json

{
  "title": "string",
  "status": 400,
  "detail": "string"
}

Enviar um pedido

curl 'https://api.example.org/v3/consignments' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer demo-token' \
  -H 'X-Request-Id: 00000000-0000-4000-8000-000000000000' \
  -d '{
  "reference": "HB-1042",
  "status": "booked"
}'

Editar esta página