Update a carrier
Partial update of a carrier: send only the fields that change; fields you omit keep their stored value. Accepts an API key, or a signed-in organization admin. tms_carrier_id, mc_number and dot_number must not belong to another of the organization’s carriers (409). is_active is rejected: flips go through POST /carriers/{id}/disable or /enable so every state change carries a reason and an audit row.
Authentication: Supports API key and bearer token authentication.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Headers
A unique key (up to 255 printable ASCII characters, e.g. a UUID) that makes a retry of this request safe. Envoy stores the response for 24 hours; a retry with the same key and the same request returns it again with Idempotent-Replayed: true instead of running twice. The same key with a different request returns 422 idempotency_key_reused; while the first request is still running, 409 idempotency_key_in_progress. 5xx and 429 responses are not stored.
Request
Main carrier contact phone (any common format, stored as E.164)
Dispatcher phone (any common format, stored as E.164)
Not accepted here: use POST /carriers/{id}/disable or /enable
MC number; stored as digits only
USDOT number; stored as digits only
Equipment types the carrier runs (replaces the stored list; an empty list clears it)
On-time pickup percentage (0-100)
On-time delivery percentage (0-100)
Response
Carrier status as reported by the source TMS (e.g. DNL). Read by the inbound email gate when the organization opts in to operational restriction notices for inactive carriers with this status.
On-time pickup percentage (0-100 scale)
On-time delivery percentage (0-100 scale)
Global routing-guide priority tier (1 = highest, 4 = lowest). None = untiered.
Strongest routing-guide tier this carrier holds on the lane the list was filtered to (1 = highest). Null when the list has no lane filter, or the carrier is untiered on it.
The tier that actually applies: lane_routing_guide_tier when set, else routing_guide_tier. Equal to the global tier on an unfiltered list.
The verdict of Envoy’s most recent compliance check on the carrier: PASSED or BLOCKED, or UNVERIFIED when no check has run yet or the last check could not reach a result.
When the carrier last asked not to be contacted; Envoy stops contacting them
Which compliance provider issued the most recent verification (e.g. Highway or MyCarrierPackets). Distinct from provider, which is the system the carrier record came from. Null when no verification has run, or when the provider was not recorded.