Skip to main content
POST
Bulk Delete Business Travels
← Business Travels API
Deprecated. Use POST /v2/business-travels/delete: up to 5,000 business travels per request, idempotent, deleted asynchronously, 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/business-travels/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).
Permanently deletes multiple business travel records and their associated total_impacts rows in a single request. Records that belong to a different organization are reported as failed rather than raising an error. Progress is tracked via a processing job.
Permanent Action: Deleted records cannot be recovered. The associated emissions data will also 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
string
required
Must be application/json

Body Parameters

array[uuid]
required
List of business travel UUIDs to deleteConstraints: 1 to 100,000 items per request
boolean
default:"false"
Also move to the trash the files uploaded for these records that no record uses after the delete.

Response

integer
Number of items successfully deleted
array[string]
UUIDs of business travels that were successfully deleted
integer
Number of items that failed to delete
array[string]
UUIDs that could not be deleted (not found, belong to a different organization, or deletion error)
string
Human-readable summary message

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

422 Unprocessable Entity

Cause: Empty list or exceeds 100,000 items

Delete

Delete a single business travel

Bulk Delete by Filters

Delete all records matching filter criteria

List Business Travels

Browse all business travels