Skip to main content
POST
Bulk Delete Wastes

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_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Body 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

Returns 200 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

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

422 Validation Error

Cause: Invalid request body (e.g. empty waste_ids array or exceeding 100,000 IDs)

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