PUT
Change a trip vehicle
Company space For: Stock keeper, Manager · Permission: trip_vehicles.update Conditions
  • Only the company that owns the trip can change it; a trip shared by another company can be read but not modified.
  • Only a trip whose status is active can be modified; an archived trip is refused with a validation error.
  • asset_id is refused: only driver_label can be changed.
  • load_weight and load_volume are refused.
What else happens
  • Only driver_label changes; sending null clears it.
Part of Reusable trips and waypoints.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

trip
string
required

Identifier of the trip (27-character KSUID). The trip must be visible to the calling company.

vehicle
string
required

Identifier of the trip vehicle link (not the asset id); it must belong to the trip in the URL.

Body

application/json
asset_id
string
required

Identifier of the vehicle to attach. Required on creation; must be a vehicle of the organization, and attached only once per trip. Not accepted on update.

Required string length: 27
load_weight
string

Not accepted: trip vehicles no longer carry load dimensions.

load_volume
string

Not accepted: trip vehicles no longer carry load dimensions.

driver_label
string | null

Optional free-text name or label of the driver, up to 255 characters; null clears it.

Maximum string length: 255

Response

TripVehicleResource

id
string
required

Identifier of the trip vehicle link (27-character KSUID).

trip_id
string
required

Identifier of the trip.

asset_id
string
required

Identifier of the vehicle asset.

driver_label
string | null
required

Free-text label of the driver; null when none.

created_at
string<date-time>
required

Date and time the record was created (ISO 8601, UTC).

updated_at
string<date-time>
required

Date and time the record was last changed (ISO 8601, UTC).