Deletes a driver from the system by their driver ID. This endpoint requires admin authentication via JWT token.
Endpoint
Despite being a POST request, this endpoint performs a delete operation. It’s configured this way in the Nitro.js handler.
Authentication
This endpoint requires admin privileges. Include a valid JWT token in the request body with userType: "admin".
Request body
JWT authentication token with admin privileges
Unique identifier of the driver to delete
Response
JSON string containing the deleted driver object or error message
Error codes
Driver successfully deleted
Bad Request - Missing or invalid token
Unauthorized - Invalid token or token has expired
Forbidden - User does not have admin privileges
Example request
curl -X POST https://api.example.com/api/drivers/delete \
-H "Content-Type: application/json" \
-d '{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"driverId": "max_verstappen"
}'
Example response
Success (200)
{
"status": 200,
"body": "{\"driverId\":\"max_verstappen\",\"code\":\"VER\",\"permanentNumber\":1,\"givenName\":\"Max\",\"familyName\":\"Verstappen\",\"dateOfBirth\":\"1997-09-30T00:00:00.000Z\",\"nationality\":\"Dutch\",\"url\":\"http://en.wikipedia.org/wiki/Max_Verstappen\",\"driverImage\":\"https://example.com/images/verstappen.jpg\",\"teamId\":\"red_bull\"}"
}
Error - Forbidden (403)
{
"status": 403,
"body": "{\"error\":\"Forbidden\"}"
}
Error - Unauthorized (401)
{
"status": 401,
"body": "{\"error\":\"Token has expired\"}"
}
Error - Bad Request (400)
{
"status": 400,
"body": "{\"error\":\"Bad Request\"}"
}
Important notes
Deleting a driver may fail if there are related records in other tables (such as Bets or Results) due to foreign key constraints. Ensure all related data is handled appropriately before deletion.