bulk_delete_forms

Delete multiple Tally forms in bulk using specified filters or form IDs. Requires a confirmation workflow: preview, confirm, and execute. Ensures safe, controlled deletions with options for batch processing, retries, and error handling.

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
`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"
}

Tally MCP