Skip to main content
POST
/
v1
/
vehicles
/
bulk-delete
Bulk Delete Vehicles
const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-organization-id': '<x-organization-id>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({vehicle_ids: {}})
};

fetch('https://api.dcycle.io/v1/vehicles/bulk-delete', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "success_count": 123,
  "success_ids": {},
  "failed_count": 123,
  "failed_ids": {},
  "message": "<string>"
}

​
Bulk Delete Vehicles

Delete multiple vehicles in a single API call. This is more efficient than making individual delete calls when removing large numbers of vehicles.
Permanent Action: Deleting vehicles is permanent and cannot be undone. All associated consumption records and emissions data will be removed from your organization’s totals.

​
Request

​
Headers

​
x-api-key
string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
​
x-organization-id
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

​
Body Parameters

​
vehicle_ids
array[string]
required
Array of vehicle UUIDs to delete. Minimum 1, maximum 100,000 IDs per request.Example: ["550e8400-e29b-41d4-a716-446655440000", "660e8400-e29b-41d4-a716-446655440001"]

​
Response

Returns 200 OK with a JSON summary of the operation.
​
success_count
integer
Number of vehicles successfully deleted
​
success_ids
array[string]
UUIDs of successfully deleted vehicles
​
failed_count
integer
Number of vehicles that failed to delete
​
failed_ids
array[string]
UUIDs of vehicles that failed to delete (not found or deletion error)
​
message
string
Human-readable summary of the operation

​
Example

curl -X POST "https://api.dcycle.io/v1/vehicles/bulk-delete" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_ids": [
      "550e8400-e29b-41d4-a716-446655440000",
      "660e8400-e29b-41d4-a716-446655440001"
    ]
  }'

​
Successful Response

{
  "success_count": 2,
  "success_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "660e8400-e29b-41d4-a716-446655440001"
  ],
  "failed_count": 0,
  "failed_ids": [],
  "message": "Successfully deleted 2 vehicles"
}

​
Common Errors

​
401 Unauthorized

Cause: Missing or invalid API key 
{
  "detail": "Invalid API key",
  "code": "INVALID_API_KEY"
}

​
422 Validation Error

Cause: Invalid request body (e.g. empty vehicle_ids array or exceeding 100,000 IDs) 
{
  "detail": [
    {
      "loc": ["body", "vehicle_ids"],
      "msg": "ensure this value has at least 1 items",
      "type": "value_error.list.min_items"
    }
  ]
}

Delete Single Vehicle

Delete a single vehicle by ID

Bulk Delete by Filters

Delete all vehicles matching filter criteria

List Vehicles

Retrieve vehicles with filtering and pagination

Bulk Delete Consumptions

Delete multiple consumption records at once