bulk_delete_forms
Delete multiple forms in batches on Tally MCP by specifying form IDs or filters. Requires a confirmation token from preview_bulk_delete to ensure safe deletion.
Instructions
🚫 DEPRECATED: Use confirm_bulk_delete instead. This tool now requires human confirmation via the confirm_bulk_delete tool after preview_bulk_delete. The new workflow is: 1) preview_bulk_delete, 2) confirm_bulk_delete with user choice, 3) automatic execution. This tool is kept for backward compatibility but will reject calls without proper confirmation workflow.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| batchSize | No | Number of forms to process per batch (1-50, default: 10) | |
| confirmationToken | No | REQUIRED: Confirmation token from preview_bulk_delete response to proceed with deletion. This ensures you have previewed what will be deleted. | |
| filters | No | Filter criteria for selecting forms to delete | |
| formIds | No | Array of specific form IDs to delete | |
| options | No | Additional options for bulk deletion operation |
Input Schema (JSON Schema)
{
"anyOf": [
{
"required": [
"formIds",
"confirmationToken"
]
},
{
"required": [
"filters",
"confirmationToken"
]
}
],
"properties": {
"batchSize": {
"default": 10,
"description": "Number of forms to process per batch (1-50, default: 10)",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"confirmationToken": {
"description": "REQUIRED: Confirmation token from preview_bulk_delete response to proceed with deletion. This ensures you have previewed what will be deleted.",
"type": "string"
},
"filters": {
"description": "Filter criteria for selecting forms to delete",
"properties": {
"createdAfter": {
"description": "ISO date string - delete forms created after this date",
"type": "string"
},
"createdBefore": {
"description": "ISO date string - delete forms created before this date",
"type": "string"
},
"namePattern": {
"description": "RegEx pattern to match form names (e.g., \"E2E.*\" for E2E Test forms, \".*Test.*\" for any test forms)",
"type": "string"
},
"status": {
"description": "Filter forms by status",
"enum": [
"draft",
"published",
"archived"
],
"type": "string"
}
},
"type": "object"
},
"formIds": {
"description": "Array of specific form IDs to delete",
"items": {
"type": "string"
},
"type": "array"
},
"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"
},
"dryRun": {
"description": "Preview what would be deleted without actually deleting",
"type": "boolean"
},
"maxRetries": {
"default": 3,
"description": "Maximum number of retry attempts per form (0-10)",
"maximum": 10,
"minimum": 0,
"type": "number"
}
},
"type": "object"
}
},
"type": "object"
}