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));

import requests

url = "https://api.dcycle.io/v1/vehicles/bulk-delete"

payload = { "vehicle_ids": {} }
headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.dcycle.io/v1/vehicles/bulk-delete \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>' \
  --data '
{
  "vehicle_ids": {}
}
'

{
  "success_count": 123,
  "success_ids": {},
  "failed_count": 123,
  "failed_ids": {},
  "message": "<string>"
}

POST

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));

import requests

url = "https://api.dcycle.io/v1/vehicles/bulk-delete"

payload = { "vehicle_ids": {} }
headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.dcycle.io/v1/vehicles/bulk-delete \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>' \
  --data '
{
  "vehicle_ids": {}
}
'

{
  "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

string

required

Your API key for authenticationExample: sk_live_1234567890abcdef

string

required

Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Body Parameters

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.

integer

Number of vehicles successfully deleted

array[string]

UUIDs of successfully deleted vehicles

integer

Number of vehicles that failed to delete

array[string]

UUIDs of vehicles that failed to delete (not found or deletion error)

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"
    ]
  }'

import requests
import os

api_key = os.getenv("DCYCLE_API_KEY")
org_id = os.getenv("DCYCLE_ORG_ID")

headers = {
    "x-api-key": api_key,
    "x-organization-id": org_id,
    "Content-Type": "application/json"
}

payload = {
    "vehicle_ids": [
        "550e8400-e29b-41d4-a716-446655440000",
        "660e8400-e29b-41d4-a716-446655440001"
    ]
}

response = requests.post(
    "https://api.dcycle.io/v1/vehicles/bulk-delete",
    headers=headers,
    json=payload
)

result = response.json()
print(f"Deleted: {result['success_count']}, Failed: {result['failed_count']}")
print(result["message"])

const axios = require('axios');

const apiKey = process.env.DCYCLE_API_KEY;
const orgId = process.env.DCYCLE_ORG_ID;

const headers = {
  'x-api-key': apiKey,
  'x-organization-id': orgId,
  'Content-Type': 'application/json'
};

const payload = {
  vehicle_ids: [
    '550e8400-e29b-41d4-a716-446655440000',
    '660e8400-e29b-41d4-a716-446655440001'
  ]
};

axios.post(
  'https://api.dcycle.io/v1/vehicles/bulk-delete',
  payload,
  { headers }
)
.then(response => {
  const result = response.data;
  console.log(`Deleted: ${result.success_count}, Failed: ${result.failed_count}`);
  console.log(result.message);
})
.catch(error => console.error(error));

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

CSV Import Bulk Delete Vehicles by Filters

​Bulk Delete Vehicles

​Request

​Headers

​Body Parameters

​Response

​Example

​Successful Response

​Common Errors

​401 Unauthorized

​422 Validation Error

​Related Endpoints

Delete Single Vehicle

Bulk Delete by Filters

List Vehicles

Bulk Delete Consumptions

Bulk Delete Vehicles

Request

Headers

Body Parameters

Response

Example

Successful Response

Common Errors

401 Unauthorized

422 Validation Error

Related Endpoints