delete_project
Permanently delete a project and all its sub-projects, tasks, comments, labels, and assignees in one cascading action. Verify the project ID first to avoid unintended removal.
Instructions
Delete a project, everything in it, and every project under it.
This cascades. Deleting a parent takes its sub-projects, every task in all of them, and each task's comments, labels, and assignees. Checked against Vikunja 2.5.0 with a parent, one sub-project, and a task: all three ids read 404 afterwards.
Vikunja soft-deletes and documents a 30 day retention window, while exposing no
endpoint to list or restore anything deleted. Through this API the call is
permanent. Confirm the id with list_projects first, and look there for a
parent_project_id matching this one: any project that names it goes too.
To put a project out of the way and keep it, call update_project with
is_archived: true.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>"
},
"name": "delete_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes |