EndpointsCollections

Delete collection

Deletes the collection (soft-delete). Routes inside it are not deleted. PAT callers must set X-Routess-Confirm: true.

DELETE
/collections/{id}

Authorization

headerAuthorizationBearer <token>

Personal access token for non-browser clients. Mint at Settings → API Tokens. Carries one of two scopes: read (list/get Routes, export GPX, profile) or write (read plus metadata-only mutations on owned routes and on preferences). Blocked from /admin/* and from DELETE /users/me. Destructive operations require X-Routess-Confirm: true and return 428 PRECONDITION_REQUIRED otherwise. See ADR-0022 and ADR-0023.

Path Parameters

id*number

Collection ID

Header Parameters

X-Routess-Confirm?string

Required as true for PAT callers. Cookie sessions ignore this header.

Response Body

response?unknownapplication/json
curl -X DELETE 'https://api.routess.com/collections/0'
{  "success": true,  "message": "Collection deleted successfully"}