confirm_bulk_delete
Confirm bulk deletion in Tally MCP by requiring the exact phrase "DELETE ALL" from a human user. Ensures safe and deliberate removal of multiple forms, with options to exclude items, manage batch sizes, and handle errors.
Instructions
HUMAN CONFIRMATION: Confirm bulk deletion ONLY after human responds with exact phrase "DELETE ALL". DO NOT call this automatically - requires genuine human confirmation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| batchSize | No | Number of forms to process per batch (1-50, default: 10) | |
| confirmationToken | Yes | Confirmation token from preview_bulk_delete response | |
| excludeFormIds | No | Form IDs to exclude from deletion (only used with select_individual choice) | |
| humanConfirmation | Yes | REQUIRED: Exact phrase from human user. Must be "DELETE ALL" to proceed or "CANCEL" to abort. Any other value cancels operation. | |
| options | No | Additional options for bulk deletion operation | |
| userChoice | No | Legacy parameter - use humanConfirmation instead. User confirmation choice: delete_all (proceed with all previewed items), select_individual (choose specific items to exclude), cancel (abort operation) |
Input Schema (JSON Schema)
{
"properties": {
"batchSize": {
"default": 10,
"description": "Number of forms to process per batch (1-50, default: 10)",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"confirmationToken": {
"description": "Confirmation token from preview_bulk_delete response",
"type": "string"
},
"excludeFormIds": {
"description": "Form IDs to exclude from deletion (only used with select_individual choice)",
"items": {
"type": "string"
},
"type": "array"
},
"humanConfirmation": {
"description": "REQUIRED: Exact phrase from human user. Must be \"DELETE ALL\" to proceed or \"CANCEL\" to abort. Any other value cancels operation.",
"type": "string"
},
"options": {
"description": "Additional options for bulk deletion operation",
"properties": {
"baseRetryDelay": {
"default": 1000,
"description": "Base delay in milliseconds for exponential backoff retries",
"maximum": 10000,
"minimum": 100,
"type": "number"
},
"continueOnError": {
"description": "Continue processing even if some deletions fail",
"type": "boolean"
},
"delayBetweenBatches": {
"description": "Milliseconds to wait between batches (for rate limiting)",
"type": "number"
},
"maxRetries": {
"default": 3,
"description": "Maximum number of retry attempts per form (0-10)",
"maximum": 10,
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"userChoice": {
"description": "Legacy parameter - use humanConfirmation instead. User confirmation choice: delete_all (proceed with all previewed items), select_individual (choose specific items to exclude), cancel (abort operation)",
"enum": [
"delete_all",
"select_individual",
"cancel"
],
"type": "string"
}
},
"required": [
"confirmationToken",
"humanConfirmation"
],
"type": "object"
}