User GuideDeveloper DocsAPI Reference
EndpointsRoutes

Delete route

Deletes a specific route for the authenticated user. PAT callers must set X-Routess-Confirm: true.

DELETE
/routes/{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

Route ID

Header Parameters

X-Routess-Confirm?string

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

Response Body

Route deleted successfully

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

Update route

Updates a specific route for the authenticated user.

Get all user collections

Retrieves all collections belonging to the authenticated user, newest first.