Bulk Delete Wastes
const options = {
method: 'POST',
headers: {
'x-api-key': '<x-api-key>',
'x-organization-id': '<x-organization-id>',
'Content-Type': 'application/json'
},
body: JSON.stringify({waste_ids: {}})
};
fetch('https://api.dcycle.io/v1/waste/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/waste/bulk-delete"
payload = { "waste_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/waste/bulk-delete \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>' \
--data '
{
"waste_ids": {}
}
'{
"success_count": 123,
"success_ids": {},
"failed_count": 123,
"failed_ids": {},
"message": "<string>"
}Bulk Delete Wastes
Delete multiple waste records in a single operation
POST
/
v1
/
waste
/
bulk-delete
Bulk Delete Wastes
const options = {
method: 'POST',
headers: {
'x-api-key': '<x-api-key>',
'x-organization-id': '<x-organization-id>',
'Content-Type': 'application/json'
},
body: JSON.stringify({waste_ids: {}})
};
fetch('https://api.dcycle.io/v1/waste/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/waste/bulk-delete"
payload = { "waste_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/waste/bulk-delete \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>' \
--data '
{
"waste_ids": {}
}
'{
"success_count": 123,
"success_ids": {},
"failed_count": 123,
"failed_ids": {},
"message": "<string>"
}Bulk Delete Wastes
Delete multiple waste records in a single API call. This is more efficient than making individual delete calls when removing large numbers of records.Permanent Action: Deleting waste records is permanent and cannot be undone. All associated emissions data will be removed from your organization’s totals.
Request
Headers
string
required
Your API key for authenticationExample:
sk_live_1234567890abcdefstring
required
Your organization UUIDExample:
a8315ef3-dd50-43f8-b7ce-d839e68d51faBody Parameters
array[string]
required
Array of waste record UUIDs to delete. Minimum 1, maximum 100,000 IDs per request.Example:
["550e8400-e29b-41d4-a716-446655440000", "660e8400-e29b-41d4-a716-446655440001"]Response
Returns200 OK with a JSON summary of the operation.
integer
Number of waste records successfully deleted
array[string]
UUIDs of successfully deleted waste records
integer
Number of records that failed to delete
array[string]
UUIDs of records 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/waste/bulk-delete" \
-H "x-api-key: ${DCYCLE_API_KEY}" \
-H "x-organization-id: ${DCYCLE_ORG_ID}" \
-H "Content-Type: application/json" \
-d '{
"waste_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 = {
"waste_ids": [
"550e8400-e29b-41d4-a716-446655440000",
"660e8400-e29b-41d4-a716-446655440001"
]
}
response = requests.post(
"https://api.dcycle.io/v1/waste/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 = {
waste_ids: [
'550e8400-e29b-41d4-a716-446655440000',
'660e8400-e29b-41d4-a716-446655440001'
]
};
axios.post(
'https://api.dcycle.io/v1/waste/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 wastes"
}
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. emptywaste_ids array or exceeding 100,000 IDs)
{
"detail": [
{
"loc": ["body", "waste_ids"],
"msg": "ensure this value has at least 1 items",
"type": "value_error.list.min_items"
}
]
}
Related Endpoints
Bulk Delete by Filters
Delete all waste records matching filter criteria
Unique Values
Get unique values for waste fields
List Wastes
Retrieve waste records with filtering and pagination
Create Waste
Add a new waste record
Was this page helpful?