Archive a trip
DELETE/v1/trips/{tripId}
Archives (soft-deletes) a trip, as Archive does in the app, subject to your trip-deletion permission (none / own trips / the agency's). The trip leaves every list and read. Undo with POST /changes/{changeId}/revert, or restore it with POST /trips/{tripId}/restore.
Permissions: trips:write · Kind: destructive · Cost: 1 unit · MCP tool archive_trip
Undoable: the response carries Bymundi-Change-Id; revert it with POST /v1/changes/{changeId}/revert.
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
tripId |
uuid | yes |
Query parameters
None.
Response 200
| Field | Type | Required | Description |
|---|---|---|---|
object |
"archived_trip" | yes | |
id |
uuid | yes | |
code |
string | yes | |
title |
string | yes | |
startDate |
string | null | yes | |
endDate |
string | null | yes | |
archivedAt |
string | yes | |
archivedBy |
string | null | 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