> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "Delete task"
description: "Permanently delete a task. This action cannot be undone."
api: "DELETE /tasks/{taskId}"
gridGap: 30
---

<Aside full>

<RequestExample>

```bash lines=false
curl -X DELETE "https://api.example.com/v1/tasks/<taskId>" \
  -H "Authorization: Bearer <token>"
```

</RequestExample>

</Aside>

<OpenAPIEndpoint {...{"method":"delete","path":"/tasks/{taskId}","summary":"Delete task","description":"Permanently delete a task. This action cannot be undone.","parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":[{"status":"204","description":"Task deleted"},{"status":"404","description":"Task not found"}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"JWT token from /auth/login"}],"servers":[{"url":"https://api.example.com/v1","description":"Production"}]}} />

---

*Powered by [holocron.so](https://holocron.so)*