Delete task

Permanently delete a task owned by the authenticated user.

Path parameters

taskId · number · required

ID of the task to delete.

Response

204 No Content — The task was deleted. The response body is empty.

All task completion records associated with this task are also deleted automatically via the database ON DELETE CASCADE constraint.

Errors

Status	Condition
400	The task exists but belongs to a different user.
404	No task found with the given taskId.
401	Missing or invalid authentication token.

cURL

curl --request DELETE \
  --url http://localhost:3000/api/tasks/42 \
  --header 'Authorization: Bearer <token>'

204

(empty body)

{
  "error": "Task not found"
}

{
  "error": "You don't have permission to delete this task"
}

{
  "error": "User not authenticated"
}