Skip to main content
DELETE
/
api
/
projects
/
{id}
Delete Project
curl --request DELETE \
  --url https://api.example.com/api/projects/{id}
{
  "warning": {}
}
Deletes a project and all associated data (tasks and task types). The project must belong to the authenticated user.

​
Authentication

Requires Bearer token authentication.

​
Path Parameters

​
id
integer
required
The unique identifier of the project to delete

​
Response

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

​
Example Request

curl -X DELETE https://api.example.com/api/projects/1 \
  -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
Project not found or does not belong to the authenticated user
{
  "error": "Not Found",
  "message": "Project not found"
}
​
warning
warning
This action is irreversible. Deleting a project will also delete all associated tasks and task types due to cascade deletion.

Build docs developers (and LLMs) love

Get started for freeTalk to us