Kommende Version

Sie lesen die Dokumentation einer kommenden Version. Dokumentation und Funktionen können sich noch ändern.

Diese Seite ist noch nicht in deiner Sprache verfügbar

Du liest sie auf English (UK).

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.

Autorisierung

Eines davon genügt
- apiKeyapiKey · X-Api-Key · Kopfzeile
  A key from the account page.
Eines davon genügt
- bearerhttp · bearer
  A token obtained from the authorisation server.

Parameter

Pfad

consignmentId*Erforderlichstring

Anfragekörper Erforderlich

application/json

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

referencestringMindestlänge 1Höchstlänge 120
statusstringbooked | loading | sailing | landed | cancelled
insuredbooleanWhether the load is covered.
priorityintegermin 1max 100How far up a berth queue this consignment sorts.

json

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

Antworten

200

The consignment as it now stands.

application/json

objectConsignmentOne consignment, as the API sees it.

id*ErforderlichstringNur lesbar
reference*ErforderlichstringMindestlänge 1Höchstlänge 120
status*ErforderlichstringConsignmentStatusbooked | loading | sailing | landed | cancelledWhere a consignment has got to.
createdAtstringNur lesbar
parentanyConsignmentVerweist auf sich selbst; oben ausgeklappt.
tagsarray<string>eindeutig
Jedes Element
string
metadataobject
Jede weitere Eigenschaft
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*ErforderlichstringA short, human-readable summary.
status*Erforderlichintegermin 400max 599
detailstring | null

json

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

Anfrage senden

curl 'https://api.example.org/v3/consignments?limit=20&cursor=string&status=%5B%0A++%22booked%22%0A%5D&session=string' \
  -H 'Authorization: Bearer demo-token' \
  -H 'X-Request-Id: 00000000-0000-4000-8000-000000000000'

Diese Seite bearbeiten