Skip to main content
DELETE
/
api
/
task-types
/
{id}
Delete Task Type
curl --request DELETE \
  --url https://api.example.com/api/task-types/{id}
Deletes a task type owned by the authenticated user. Any tasks associated with this task type will have their task type reference set to null.

​
Authentication

Requires Bearer token authentication.

​
Path Parameters

​
id
integer
required
The unique identifier of the task type to delete

​
Response

Returns 204 No Content on successful deletion with an empty response body.

​
Example Request

curl -X DELETE https://api.example.com/api/task-types/5 \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

​
Example Response

HTTP/1.1 204 No Content

​
Error Responses

​
401 Unauthorized
Authentication token is missing or invalid
{
  "error": "Unauthorized",
  "message": "Invalid or missing authentication token"
}
​
404 Not Found
The task type does not exist or does not belong to the user
{
  "error": "Not Found",
  "message": "Task type not found"
}

​
Notes

  • When a task type is deleted, all tasks that were associated with it will have their taskType reference set to null
  • This operation cannot be undone
  • The deletion is handled by the @PreRemove hook in the TaskType entity

Build docs developers (and LLMs) love

Get started for freeTalk to us