Trash
Every Trash tool, with the scope it needs, its arguments and the API operation it calls.
4 tools
List trash cleanup runs
Read onlyatlas_trash_cleanup_runs_list
Tenant-scoped. List the last 30 nightly trash-cleanup runs for the caller's tenant. Each row carries ranAt, cutoff (the 30-day threshold applied), deletedCount (= deletedTasks + deletedProjects), and a dryRun flag for preview sweeps.
- Scope
tasks:read- Calls
- Example prompt
- Show me the last week of trash cleanup runs.
Arguments
This tool takes no arguments.
Delete trash items
Destructiveatlas_trash_items_delete
Permanently hard-delete one trashed task or project. Requires confirm=true in MCP input before sending the irreversible DELETE request.
- Scope
tasks:delete- Calls
- Example prompt
- Permanently purge task t_123 from trash after confirmation.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
kind | "task" | "project" | Yes | |
id | string | Yes | |
confirm | true | Yes |
List trash items
Read onlyatlas_trash_items_list
Tenant-scoped. List soft-deleted tasks and projects in the caller's trash, including deletedAt and restorable status. Supports kind=all/task/project and limit 1-200.
- Scope
tasks:read- Calls
- Example prompt
- Show me recently deleted projects in trash.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
kind | "all" | "task" | "project" | No | |
limit | integer | No |
Restore trash items
Changes dataatlas_trash_items_restore
Restore one soft-deleted task or project from trash. The API stays tenant-scoped and only restores rows that are still in trash.
- Scope
tasks:write- Calls
- Example prompt
- Restore project p_123 from trash.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
kind | "task" | "project" | Yes | |
id | string | Yes |