Delete a route
DELETE/v1/catalog/routes/{routeId}
Deletes a route, as its editor's Delete. Days already stamped from it in trips keep their content. Undo with POST /changes/{changeId}/revert: it re-creates the same route, with the same id.
Permissions: catalog:write · Kind: destructive · Cost: 1 unit · MCP tool delete_route
Undoable: the response carries Bymundi-Change-Id; revert it with POST /v1/changes/{changeId}/revert.
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
routeId |
uuid | yes |
Query parameters
None.
Response 200
| Field | Type | Required | Description |
|---|---|---|---|
object |
"route" | yes | |
id |
uuid | yes | |
deleted |
true | yes |
Errors
Errors are problem details. Besides the refusals described above, any call like this one can return:
invalid_request— Invalid requestunauthorized— Missing or invalid API keyinsufficient_scope— Missing permissionrate_limited— Rate limit reachednot_found— Not foundidempotency_key_reused— Idempotency-Key reusedrequest_in_progress— Request in progressforbidden— Not allowed