Update Fleet

PATCH

https://api.catenatelematics.com/v2/orgs/fleets/:fleet_id

PATCH

/v2/orgs/fleets/:fleet_id

curl -X PATCH https://api.catenatelematics.com/v2/orgs/fleets/fleet_id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "name": "Swift Transport LLC",
  "fleet_ref": "external-system-12345",
  "id": "98765432-10fe-dcba-9876-543210fedcba",
  "created_at": "2025-12-10T08:15:00Z",
  "updated_at": "2025-12-11T14:30:00Z",
  "description": "Regional freight carrier specializing in temperature-controlled transport",
  "display_name": "Swift Transport",
  "legal_name": "Swift Transport LLC",
  "dba_name": "Swift Logistics",
  "websites": [
    "https://swifttransport.com",
    "https://swiftlogistics.com"
  ],
  "regulatory_id": "1234567",
  "regulatory_id_type": "DOT",
  "regulatory_id_date": "2020-03-15",
  "regulatory_id_status": "ACTIVE",
  "registered_email": "operations@swifttransport.com",
  "registered_phone": "+14155551234",
  "registered_fax": "+14155551235",
  "address": "1234 Industrial Pkwy",
  "city": "San Francisco",
  "province": "California",
  "postal_code": "94107",
  "country_code": "USA"
}

Update an existing fleet information.

Authentication

AuthorizationBearer

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

Path parameters

fleet_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

namestring or nullOptional

Primary fleet name

descriptionstring or nullOptional

Fleet description or notes

display_namestring or nullOptional

Public-facing name

legal_namestring or nullOptional

Official registered business name

dba_namestring or nullOptional

"Doing Business As" name if different from legal name

regulatory_idstring or nullOptional

Regulatory identifier (e.g., DOT number, EASA ID)

regulatory_id_typestring or nullOptional

Type of regulatory ID (e.g., DOT, EASA, MC)

regulatory_id_datedate or nullOptional

Date when regulatory ID was issued

regulatory_id_statusstring or nullOptional

Current status of the regulatory ID

registered_emailstring or nullOptionalformat: "email"

Official contact email

registered_phonestring or nullOptionalformat: "phone"

Official contact phone number

registered_faxstring or nullOptionalformat: "phone"

Fax number if applicable

addressstring or nullOptional

Street address

citystring or nullOptional

City

provincestring or nullOptional

State/Province

postal_codestring or nullOptional

ZIP/Postal code

country_codestring or nullOptionalformat: "^\w{3}$"

ISO-3 country code (e.g., USA, CAN, GBR)

fleet_refstring or nullOptional

A reference for the fleet. Used to store an external identifier for the fleet in your system.

Response

Successful Response

namestring

fleet_refstring

An optional reference for the fleet. Used to store an external identifier for the fleet in your system.

idstringformat: "uuid"

Unique Catena fleet identifier

created_atdatetime

When the fleet was created

updated_atdatetime

Last modification timestamp

descriptionstring or nullOptional

A description of the fleet

display_namestring or nullOptional

legal_namestring or nullOptional

dba_namestring or nullOptional

websiteslist of strings or nullOptional

List of websites associated with the fleet. The website is used to map users to an organization based on their email domain and to authenticate them accordingly in the scope of the organization.

invitation_idstring or nullOptionalformat: "uuid"

ID of the invitation that was used to onboard the fleet

regulatory_idstring or nullOptional

Primary identifier from a regulatory body for a fleet (like DOT Number).

regulatory_id_typestring or nullOptional

Type of the regulatory ID like DOT, EASA, etc.

regulatory_id_datedate or nullOptional

Date when the regulatory ID was issued.

regulatory_id_statusstring or nullOptional

Status of the regulatory ID.

registered_emailstring or nullOptionalformat: "email"

Email address that is registered for the fleet.

registered_phonestring or nullOptionalformat: "phone"

Phone number that is registered for the fleet.

registered_faxstring or nullOptionalformat: "phone"

Fax number that is registered for the fleet.

addressstring or nullOptional

Physical address that is registered for the fleet.

citystring or nullOptional

City that is registered for the fleet.

provincestring or nullOptional

Province that is registered for the fleet.

postal_codestring or nullOptional

Postal code that is registered for the fleet.

country_codestring or nullOptionalformat: "^\w{3}$"

ISO-3 Country code that is registered for the fleet.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

405

Method Not Allowed Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error