Skip to main content
DELETE
Delete Transport Route

Delete Transport Route

Permanently delete a transport route by its unique identifier. All associated transport sections and their calculated emissions (total_impacts) records are deleted automatically in the same operation.
This action is irreversible. All sections and their emission impact records will be permanently removed.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Path Parameters

string
required
The unique identifier (UUID) of the transport route to deleteExample: 010ed3b6-b513-40f3-b9fe-0f0a338d9274

Response

Returns 204 No Content on success. The response body is empty.

Example

Successful Response

No response body is returned.

Common Errors

401 Unauthorized

Cause: Missing or invalid API key / JWT token

403 Forbidden

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

404 Not Found

Cause: Route ID does not exist or belongs to a different organization

List Transport Routes

Retrieve all transport routes to find IDs before deleting

Get Transport Route

Retrieve a specific route before deleting

Create Transport Route

Create a new transport route with sections

Get Route Counts

Confirm counts decrease after deletion

Transport Overview

Full data model and distance calculation reference