Skip to main content

​
DELETE /api/tasks/{task_id}

Permanently deletes a task. Regular users can only delete tasks they own; admin users can delete any task.
Deletion is permanent and cannot be undone. All data associated with the task, including tag associations, is removed.

​
Authentication

Authorization: Bearer <access_token>

​
Path Parameters

​
task_id
integer
required
The unique ID of the task to delete.

​
Response

200 OK — The task was successfully deleted.
​
success
boolean
Always true for successful responses.
​
message
string
Confirmation message: "Tarea eliminada con exito".

​
Error Responses

StatusDescription
403 ForbiddenThe authenticated user does not own this task and is not an admin.
404 Not FoundNo task with the given task_id exists.

​
Example

curl -X DELETE "https://task-forge-gbd6h8gtg8hchve9.chilecentral-01.azurewebsites.net/api/tasks/42" \
  -H "Authorization: Bearer <access_token>"
Example response: 
{
  "success": true,
  "message": "Tarea eliminada con exito"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us