Skip to main content
PATCH
Update a truck
Send only what changed. Fields you leave out stay as they are. New dates move expires_at, with the same date rules as posting. A removed truck can’t be updated (404); post a new one.

Authorizations

Authorization
string
header
required

One key per broker rep or per carrier signup. Keep it secret.

Path Parameters

truck_id
string<uuid>
required

The truck_id from POST /v1/carrier/trucks.

Body

application/json

A truck as fields. To post, equipment_type, current_city, current_state and available_from are required. To update, send only what changed.

equipment_type
string
Example:

"Reefer"

trailer_length_ft
integer
Required range: 1 <= x <= 60
Example:

53

current_city
string
Example:

"Dallas"

current_state
string

US state or Canadian province code (any case; stored upper-case).

Required string length: 2
Example:

"TX"

available_from
string<date-time>

When the truck is free (RFC 3339, e.g. 2026-10-23T08:00:00-05:00). Up to 60 days out.

available_to
string<date-time>

When it stops being free. Not before available_from. Leave it out and the post lapses 72 hours after available_from.

destinations
object[]

Where the truck wants to go. Each needs a 2-letter state; city is optional.

rate_ask
object

What the carrier wants for the truck.

notes
string

Response

The updated truck.

truck_id
string<uuid>
required
status
enum<string>
required

active: posted. removed: taken down (see removed_reason). expired: past expires_at.

Available options:
active,
removed,
expired
equipment_type
string
required
current_city
string
required
current_state
string
required
available_from
string<date-time>
required
destinations
object[]
required
expires_at
string<date-time>
required

available_to, or 72 hours after available_from when there's no end.

created_at
string<date-time>
required
trailer_length_ft
integer
available_to
string<date-time>
rate_ask
object

What the carrier wants for the truck.

notes
string
removed_reason
enum<string>
Available options:
loaded,
unavailable,
other