Bulk Delete Vehicle Consumptions (Organization)
const options = {
method: 'POST',
headers: {
'x-api-key': '<x-api-key>',
'x-organization-id': '<x-organization-id>',
'Content-Type': 'application/json'
},
body: JSON.stringify({consumption_ids: {}, delete_source_files: true})
};
fetch('https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete"
payload = {
"consumption_ids": {},
"delete_source_files": True
}
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/v2/vehicle_consumptions/bulk-delete \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>' \
--data '
{
"consumption_ids": {},
"delete_source_files": true
}
'{
"success_count": 123,
"success_ids": {},
"failed_count": 123,
"failed_ids": {},
"message": "<string>"
}Bulk Delete Vehicle Consumptions (Organization)
Delete multiple consumption records by ID, across any vehicle in the organization
POST
/
v2
/
vehicle_consumptions
/
bulk-delete
Bulk Delete Vehicle Consumptions (Organization)
const options = {
method: 'POST',
headers: {
'x-api-key': '<x-api-key>',
'x-organization-id': '<x-organization-id>',
'Content-Type': 'application/json'
},
body: JSON.stringify({consumption_ids: {}, delete_source_files: true})
};
fetch('https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete"
payload = {
"consumption_ids": {},
"delete_source_files": True
}
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/v2/vehicle_consumptions/bulk-delete \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>' \
--data '
{
"consumption_ids": {},
"delete_source_files": true
}
'{
"success_count": 123,
"success_ids": {},
"failed_count": 123,
"failed_ids": {},
"message": "<string>"
}← Vehicles API
Delete multiple consumption records by their IDs in a single call — the consumptions don’t need to belong to the same vehicle. Use this from an “all consumptions” table view where a user has selected specific rows across multiple vehicles.
Deprecated. Use
POST /v2/vehicle-consumptions/delete: many vehicle consumptions per request by id, idempotent, deleted asynchronously as an ingest job, with webhooks. To also move to the trash the uploaded files that no record uses after the delete (delete_source_files), use this endpoint: the v2 delete does not. This endpoint keeps working; its responses carry Deprecation and Link: </v2/vehicle-consumptions/delete>; rel="successor-version" headers. Its responses also carry Sunset: Fri, 30 Apr 2027 00:00:00 GMT: the endpoint is retired on April 30, 2027 (see the changelog).Permanent Action: Deleting consumption records is permanent and cannot be undone. All associated emissions data will be removed from your organization’s totals.
Consumption IDs that don’t exist, or whose vehicle belongs to a different organization, are reported in
failed_ids rather than causing the whole request to fail. Always check failed_count after a 200 response.Request
Headers
Body Parameters
Array of consumption record UUIDs to delete, from any vehicle in the organization. Minimum 1, maximum 100,000 IDs per request.Example:
["660e8400-e29b-41d4-a716-446655440000", "770e8400-e29b-41d4-a716-446655440001"]Also move to the trash the files uploaded for these records that no record uses after the delete.
Response
Returns200 OK with a JSON summary of the operation.
UUIDs of records that failed to delete (not found, or owned by a different organization)
Example
curl -X POST "https://api.dcycle.io/v2/vehicle_consumptions/bulk-delete" \
-H "x-api-key: ${DCYCLE_API_KEY}" \
-H "x-organization-id: ${DCYCLE_ORG_ID}" \
-H "Content-Type: application/json" \
-d '{
"consumption_ids": [
"660e8400-e29b-41d4-a716-446655440000",
"770e8400-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 = {
"consumption_ids": [
"660e8400-e29b-41d4-a716-446655440000",
"770e8400-e29b-41d4-a716-446655440001"
]
}
response = requests.post(
"https://api.dcycle.io/v2/vehicle_consumptions/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 = {
consumption_ids: [
'660e8400-e29b-41d4-a716-446655440000',
'770e8400-e29b-41d4-a716-446655440001'
]
};
axios.post(
'https://api.dcycle.io/v2/vehicle_consumptions/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": [
"660e8400-e29b-41d4-a716-446655440000",
"770e8400-e29b-41d4-a716-446655440001"
],
"failed_count": 0,
"failed_ids": [],
"message": "Successfully deleted 2 vehicle consumption(s)"
}
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. emptyconsumption_ids array or exceeding 100,000 IDs)
{
"detail": [
{
"loc": ["body", "consumption_ids"],
"msg": "ensure this value has at least 1 items",
"type": "value_error.list.min_items"
}
]
}
Related Endpoints
List Vehicle Consumptions (Organization)
List all consumptions across every vehicle, with filters
Bulk Delete by Filters (Organization)
Delete every consumption matching the current filters, e.g. an entire uploaded file
Bulk Delete Consumptions
Delete consumptions scoped to a single vehicle
Was this page helpful?