Update Submission Status is a WordPress ability from Fluent Forms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Update Submission Status
WriteSet one entry's status — unread, read, spam, or trashed.
Needs the Fluent Forms MCP server switched on in FluentForm → Settings → MCP, and WordPress 6.9+ so wp_register_ability() exists (abilities are only registered when the function is present). Reaching the server also requires a logged-in WordPress user holding at least one FluentForm capability. Each ability additionally checks a specific FluentForm capability (e.g. fluentform_dashboard_access, fluentform_forms_manager, fluentform_entries_viewer, fluentform_manage_entries, fluentform_view_payments, fluentform_settings_manager) via the plugin's own Acl system, and every write ability requires a two-step dry_run → confirm_token round-trip through WriteGuard before anything is persisted. Note (from source comments): a WordPress role granted FluentForm access via the Role Manager passes every per-ability capability check, including delete-submission and bulk delete_permanently — the real boundary for such a user is 'has FluentForm access, restricted to their form scope', not per-tool separation; only individually-assigned 'specific forms' managers are gated the way each ability's declared capability implies.
What it does
Changes a single entry's status to unread, read, spam, or trashed. trashed is a soft delete — the entry is not removed and can be restored by setting a different status. The confirm_token binds both the entry id and the target status, so a token minted while previewing one status change can never be replayed to apply a different one. Requires dry_run:true first to preview the from/to status and obtain a confirm_token, then a repeat call with the same parameters plus confirm_token to execute.
See it in action
You ask your AI assistant
"Mark entry 245 as read."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| entry_id | integer | Yes | The submission id to update. |
| status | string | Yes | unread, read, spam, or trashed. |
| dry_run | boolean | No | Preview the change without writing; returns a confirm_token. |
| confirm_token | string | No | The token from the dry_run preview, required to execute. |
| idempotency_key | string | No | Optional; a retry with the same key will not act twice. |
Returns
On dry_run: the entry_id, form_id, current (from) and target (to) status, a reversible flag, and a confirm_token. On execute: the entry id and its new status.
Permission
Requires the fluentform_manage_entries capability.
More Fluent Forms abilities
Add Submission Note
Attach an internal staff note to one entry; not visible to the submitter.
Bulk Update Submissions
Apply one action — read, unread, trashed, favorite, unfavorite, or permanent delete — to up to 200 entries at once.
Create Form
Create a new form from a title and an ordered list of fields, or a basic contact form by default.
Create or Update Email Notification
Create a new email notification or update an existing one — including its recipient.
Delete Submission
Permanently delete one entry and its uploaded files.
Get Form
Load one form's full detail, including its field schema, so the agent knows the exact field keys used in submissions.