Permanently delete (irreversible)
permanent_delete_entityPermanently and IRREVERSIBLY hard-delete an entity from the recycle bin. The entity and all its children are removed from the database — this cannot be undone. Requires Admin role. Call once with no token to preview; re-call with the returned confirm_token and an idempotency_key to commit. entity_type must be one of: Customer, Project, Task, SubTask. Refused (CONFLICT.STATE_CONFLICT) when the entity is not in the recycle bin (reason NOT_IN_RECYCLE_BIN) or when anything under it is live - restored, or never deleted (reason LIVE_DESCENDANTS).
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": {
"entity_id": "<entity_id>",
"entity_type": "<entity_type>"
},
"name": "permanent_delete_entity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entity_id | Yes | Id of the recycle-bin entity to permanently delete. | |
| entity_type | Yes | Type of entity to permanently delete. One of: Customer, Project, Task, SubTask. | |
| confirm_token | No | Token returned by the preview (call this tool once with no token to get it). Required to commit; expires in ~10 minutes. | |
| idempotency_key | No | Required when committing (confirm_token present): retrying with the same key returns the original result instead of acting twice. |