API documentation

PUT /buyer_fleets/:id

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/buyer_fleets/:id

Update an individual Buyer Fleet

Updates a Buyer Fleet's name, description, or user_fleet_id.

Params

Param name	Description
name Optional	The name of the buyer fleet. Must be a String
description Optional	A description for this buyer fleet. Must be a String
user_fleet_id Optional	A unique identifier for this fleet. Only lowercase letters, numbers, and underscores are allowed. This ID is used in system tokens to identify fleet membership. Must be a String

Param name

Description

name
Optional

The name of the buyer fleet.

Must be a String

description
Optional

A description for this buyer fleet.

Must be a String

user_fleet_id
Optional

A unique identifier for this fleet. Only lowercase letters, numbers, and underscores are allowed. This ID is used in system tokens to identify fleet membership.

Must be a String

Example Request

curl -X PUT 'https://[your-subdomain].trackdrive.com/api/v1/buyer_fleets/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Example Buyer Fleet (renamed)"
}'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "buyer_fleet": {
    "id": 10001,
    "type": "BuyerFleet",
    "uuid": null,
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/buyer_fleets/10001",
    "routes_edit_path": "/buyer_fleets/10001/edit",
    "external_record_id": null,
    "company_id": 10002,
    "name": "Example Buyer Fleet (renamed)",
    "description": null,
    "user_fleet_id": "example_fleet_update",
    "buyers_count": 0,
    "buyer_ids": []
  },
  "metadata": {
    "root": "buyer_fleet"
  }
}