← Abilities Directory

WS Form Abilities

WS Form exposes its form builder as abilities, letting an AI assistant list, create, read, update, clone, publish, draft, delete, and restore forms; manage tabs, sections, and fields directly; manage form styles (list, read, create, update, delete); list or read individual submissions and their notes; and pull view/submission statistics — all through a JSON-based form definition or targeted structural tools.

35

Total

13

Read

22

Write

Requires the WS Form plugin active on WordPress 6.9+ (abilities only register when the WP_Ability class exists). Style abilities (styles, style-get, style-create, style-update, style-delete) additionally require WS Form's built-in styler/form-framework feature to be enabled (on by default, filterable via the 'wsf_styler_enabled' hook). Updating forms, tabs, sections, fields, and styles additionally require the 'Allow Updates' setting to be enabled in WS Form > Settings; deleting forms requires the separate 'Allow Deletes' setting, and deleting styles requires an 'abilities_api_delete_style' option that currently has no toggle exposed in the settings UI. Each ability also checks the current user's WS Form capabilities (e.g. read_form, edit_form, create_form, delete_form, publish_form, read_submission, edit_submission, read_form_style, edit_form_style, create_form_style, delete_form_style).

Add field

Write

ws-form/field-add

Add a new field to an existing form's section.

Add section

Write

ws-form/section-add

Add a new section to a tab, optionally inserted before an existing section.

Add tab

Write

ws-form/tab-add

Add a new tab (group) to a form, optionally inserted before an existing tab.

Clone form

Write

ws-form/form-clone

Clone an existing form into a new draft copy.

Create form from a description

Write

ws-form/form-create-json

Create a brand-new WS Form from a JSON definition generated from a natural-language description.

Create style

Write

ws-form/style-create

Create a new form style, optionally from a template, with root palette values, and optionally assign it to a form or set it as a site default.

Create submission note

Write

ws-form/submission-note-create

Add a note to a form submission, optionally with structured values and action buttons.

Delete field

Destructive

ws-form/field-delete

Permanently delete a field from a form.

Delete form

Destructive

ws-form/form-delete

Trash or permanently delete a form by ID.

Delete section

Destructive

ws-form/section-delete

Permanently delete a section and its fields. Cannot delete a tab's last remaining section.

Delete style

Destructive

ws-form/style-delete

Trash or permanently delete a style by ID. Default styles cannot be deleted.

Delete submission note

Destructive

ws-form/submission-note-delete

Permanently delete a submission note by ID.

Delete tab

Destructive

ws-form/tab-delete

Permanently delete a tab and all of its sections and fields. Cannot delete a form's last remaining tab.

Draft form

Write

ws-form/form-draft

Set a published form back to draft status by ID.

Get form block markup

Read-only

ws-form/form-block

Get the Gutenberg block markup for a form by ID.

Get form in JSON format

Read-only

ws-form/form-get-json

Retrieve a form's full definition as JSON by its numeric ID.

Get form shortcode

Read-only

ws-form/form-shortcode

Get the WS Form shortcode for a form by ID.

Get statistical data about a form by ID

Read-only

ws-form/form-stats

Get view, save, and submission statistics for a form, optionally scoped to a date range.

Get style

Read-only

ws-form/style-get

Retrieve a style's details and root palette values by its numeric ID.

Get submission

Read-only

ws-form/submission-get

Retrieve a single form submission by its ID, including all field values.

List fields

Read-only

ws-form/fields

List every field on a form, with its ID, label, type, and parent section/tab.

List forms

Read-only

ws-form/forms

List all forms in WS Form, optionally filtered to only published ones and sorted by label or ID.

List sections

Read-only

ws-form/sections

List every section on a form, with its ID, label, parent tab, and position.

List styles

Read-only

ws-form/styles

List form styles in WS Form's built-in styler, optionally filtered to only published ones and sorted by label or ID.

List submission notes

Read-only

ws-form/submission-notes

List the notes attached to a form submission.

List submissions

Read-only

ws-form/submissions

List submissions for a form by ID, with optional date range, status, keyword, pagination, and ordering.

List tabs

Read-only

ws-form/tabs

List every tab (group) on a form, with its ID, label, and position.

Publish form

Write

ws-form/form-publish

Publish a draft form by ID so it can be used on a live page.

Restore form

Write

ws-form/form-restore

Restore a trashed form by ID.

Update a form from a JSON string

Write

ws-form/form-update-json

Update an existing form using JSON, keeping the same groups, sections, and fields structure returned by form-get-json.

Update field

Write

ws-form/field-update

Update an existing field's label and/or meta configuration on a form.

Update section

Write

ws-form/section-update

Update a section's label and/or meta by ID.

Update style

Write

ws-form/style-update

Update an existing style's label and/or root palette values, and optionally assign it to a form or set it as a site default.

Update submission note

Write

ws-form/submission-note-update

Update the content and/or structured meta of an existing submission note by ID.

Update tab

Write

ws-form/tab-update

Rename a tab (group) by ID.

More Forms plugins with abilities

All Forms →

Use WS Form's abilities with AI

Install Easy MCP AI on your WordPress site and any AI assistant can call these abilities in minutes.

Newsletter

The AI + WordPress space moves fast. Keep up.

New tools, workflow ideas, and product updates — be the first to know what's next.

No spam, unsubscribe anytime.