Delete SureForms Form is a WordPress ability from SureForms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Delete SureForms Form
DestructiveMove a SureForms form to trash, or permanently delete it when force is set.
Requires the SureForms plugin on WordPress 6.9+ (the Abilities API is gated behind function_exists('wp_register_ability'), so it degrades gracefully on WP 6.4-6.8). Abilities only register when the 'srfm_abilities_api' option is enabled in SureForms' AI settings, and every ability requires the current user to have the 'manage_options' capability. Abilities that create or modify data additionally require the 'srfm_abilities_api_edit' option to not be explicitly disabled; abilities that permanently delete data additionally require 'srfm_abilities_api_delete' to not be explicitly disabled.
What it does
This ability validates the form exists, then either trashes it (default) or, when force is true, permanently deletes the form post and all its metadata via wp_delete_post() — an action the plugin's own instructions describe as unrecoverable. The response reports the form_id, whether the deletion succeeded, and the form's previous status. Its annotations mark it destructive and non-idempotent, and the ability includes explicit MCP instructions to always confirm with the user before deleting, especially when force is true.
See it in action
You ask your AI assistant
"Permanently delete the old 'Event RSVP 2023' form, ID 88 — I don't need it back."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| form_id | integer | Yes | The ID of the form to delete. |
| force | boolean | No | If true, permanently deletes the form. Otherwise moves it to trash. Defaults to false. |
Returns
An object with form_id, a deleted boolean, and the form's previous_status.
Permission
Requires the 'manage_options' capability, the 'srfm_abilities_api' master option enabled, and the 'srfm_abilities_api_delete' gate option must not be explicitly disabled.
More SureForms abilities
Bulk Get Entry Details
Retrieve full submitted data for up to 50 SureForms entries in a single call.
Create SureForms Form
Create a new SureForms form from a title, an array of field definitions, and optional metadata.
Delete Entry
Permanently delete one or more SureForms submission entries.
Duplicate SureForms Form
Clone an existing SureForms form, including its fields, metadata, and settings, as a new draft.
Get Entry Details
Retrieve the full submitted data for a single SureForms entry, with field labels resolved.
Get Form Analytics
Retrieve raw submission timestamps for a date range, optionally scoped to one form, capped at 10,000 results.