Skip to main content
DELETE
/
api
/
route-calls
/
:id
Delete Route Call
curl --request DELETE \
  --url https://api.example.com/api/route-calls/:id
{
  "success": true,
  "message": "<string>",
  "401 Unauthorized": {},
  "403 Forbidden": {},
  "404 Not Found": {}
}

​
Overview

Permanently delete a route call from the system. This action cannot be undone. Only the organizer who created the route call or an admin can delete it.
This endpoint permanently deletes the route call and all associated data including meeting points and attendance records. This action cannot be undone. Consider using the cancel endpoint instead if you want to keep the record.

​
Authentication

This endpoint requires a valid Bearer token in the Authorization header: 
Authorization: Bearer <your_token>
Authorization: Only the organizer who created the route call or an admin can delete it.

​
Path Parameters

​
id
string
required
UUID of the route call to deleteExample: 123e4567-e89b-12d3-a456-426614174000

​
Response

​
success
boolean
Indicates if the request was successful
​
message
string
Success message: “Route call deleted successfully”

​
Error Responses

​
401 Unauthorized
object
Invalid or missing authentication token
{
  "success": false,
  "error": "Unauthorized"
}
​
403 Forbidden
object
User is not the organizer or an admin
{
  "success": false,
  "error": "Only organizer or admin can delete this route call"
}
​
404 Not Found
object
Route call with the specified ID does not exist
{
  "success": false,
  "error": "Route call not found"
}

​
Example Request

curl -X DELETE "https://api.losinmaduros.com/api/route-calls/123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Example Response

{
  "success": true,
  "message": "Route call deleted successfully"
}
If you want to cancel a route call instead of permanently deleting it, use:
  • PATCH /api/route-calls/:id/cancel - Sets the status to CANCELLED while preserving the record

​
Notes

  • This action is permanent and cannot be undone
  • All associated data (meeting points, attendance records) will also be deleted
  • Only the organizer or an admin can delete a route call
  • Consider cancelling instead of deleting if you want to maintain historical records
  • Deleted route calls cannot be recovered

Build docs developers (and LLMs) love

Get started for freeTalk to us