Skip to main content
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));
{
  "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

​
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

​
waste_ids
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

Returns 200 OK with a JSON summary of the operation.
​
success_count
integer
Number of waste records successfully deleted
​
success_ids
array[string]
UUIDs of successfully deleted waste records
​
failed_count
integer
Number of records that failed to delete
​
failed_ids
array[string]
UUIDs of records 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/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"
    ]
  }'

​
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. empty waste_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"
    }
  ]
}

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