Read-only
Lists the forms in your workspace (drafts and published, archived ones excluded) with their status, submission count, and public link.
InputsNone
Ask like this
Which forms do I have, and how many responses does each one have?
Technical details
Description the model receives:
Lists all forms in the workspace (drafts and published; archived forms are excluded), most recently updated first. Each row includes the form id to use with the other tools, its status, submission count, and the public fill-out URL.
readOnlyHint: true
Read-only
Shows the full structure of a form's draft: pages, fields, options, logic rules, messages, and styling, with a preview link to the draft.
Ask like this
Show me the fields on the registration form.
Technical details
Description the model receives:
Gets a form's full structure from its current draft: title, status, PDF template, base language, every page with its fields (id, type, label, required flag, the option values/labels of choice fields, the HTML content of heading and paragraph fields), the translations of the title, pages, fields and settings texts into other languages, and every conditional logic rule (id, conditions, actions) currently on the form, plus its email notifications (id, type, enabled flag, recipients) and a note saying who is emailed when a submission arrives. Fields also return their placeholder, help text, width and number min/max; the result carries the form's own settings texts (submit button, thank-you and closed messages) and its theme (logo, colours, font), so edits and cloned branding can be confirmed without publishing. It also returns a previewUrl: a link that renders the current draft, even for a form that has never been published, valid for 24 hours; submitting through it saves nothing.
readOnlyHint: true
formId string · required- Form id (GUID).
Modifies data
Creates a new form as a private draft, with its title and fields on a single page.
Ask like this
Create a contact form with name, email, and message.
Technical details
Description the model receives:
Creates a new draft form with the given title and fields on a single page. Choice fields (dropdown, radio, checkbox) need 'options'; matrix fields take 'rows' and 'columns'. The form starts as a private draft — the owner can refine it at the returned builder URL, and publishing it makes it publicly fillable.
readOnlyHint: false · destructiveHint: false
title string · required- Form title shown to respondents, e.g. "Solicitud de empleo".
fields array · required- Fields to add, in display order.
description string · optional- Optional intro text shown at the top of the form, under the title.
language string · optional- The language the title and field texts are written in: "es" (Spanish, the default), "en" (English) or "pt" (Portuguese). It becomes the form's base language, which respondents, emails and PDFs fall back to.
add_fields
Modifies data
Appends fields to the end of the draft. Works on published forms too; the changes go live when you publish again.
Ask like this
Add an optional phone field to the contact form.
Technical details
Description the model receives:
Appends fields to the end of a form's draft (its last page). Uses the same field format as form creation. Changes affect the draft only and go live when the form is published.
readOnlyHint: false · destructiveHint: false
formId string · required- Form id (GUID).
fields array · required- Fields to append, in display order.
edit_field
Destructive
Replaces a field's definition, keeping its id and position. Only on forms that have never been published: publishing locks the fields.
Ask like this
Change the “Size” field to a dropdown with S, M, and L.
Technical details
Description the model receives:
Replaces an existing field's definition (type, label, required, options, etc.) in a form's draft, keeping its id and position. Only allowed while the form has never been published — once a form is published its existing fields are locked, since respondents may already have submitted answers shaped by them; appending new fields still works on a published form's draft. Uses the same field format as form creation.
readOnlyHint: false · destructiveHint: true
formId string · required- Form id (GUID).
fieldId string · required- Id of the field to replace (e.g. "f_a1b2c3").
field object · required- The field's new definition, replacing the old one entirely.
delete_field
Destructive
Removes a field from the draft and strips it from any logic rules that used it. Only on forms that have never been published.
Ask like this
Remove the “Company” field from the sign-up form.
Technical details
Description the model receives:
Removes a field from a form's draft. Only allowed while the form has never been published — once a form is published its existing fields are locked, since respondents may already have submitted answers for them. If any logic rule referenced this field, that reference is stripped from the rule (and the rule itself removed if nothing is left of it) rather than blocking the delete.
readOnlyHint: false · destructiveHint: true
formId string · required- Form id (GUID).
fieldId string · required- Id of the field to delete (e.g. "f_a1b2c3").
Modifies data
Changes a form's title. Submissions stay the same; the public link follows the new title only while the form has never been published.
Ask like this
Rename the survey to “Satisfaction survey 2026”.
Technical details
Description the model receives:
Renames a form. Existing submissions are never affected. The public URL (slug) follows the new title while the form has never been published; once it has been published the URL stays the same, since people may already have the link.
readOnlyHint: false · destructiveHint: false · idempotentHint: true
formId string · required- Form id (GUID).
newTitle string · required- The new form title.
set_translations
Modifies data
Writes a form's texts in another language: title, pages, questions, paragraphs, options and messages. It also sets the base-language title and messages. One form serves Spanish, English and Portuguese, even once it's published.
Ask like this
Translate the contact form into Spanish, including the title and the intro paragraph.
Technical details
Description the model receives:
Sets a form's texts in one language: the form title, page titles, field labels, placeholders, help texts, heading and paragraph content, option labels, and the submit button, thank-you and closed-form messages. For a language other than the form's base language these are translations: respondents who view the form in that language (language switcher or ?culture= in the link) see them; any text left untranslated shows in the base language. Pass the form's own base language to set the form's own texts instead: only the title and the submit button, thank-you and closed-form messages can be set that way (the questions themselves are changed by editing the fields). Only the texts passed are changed: an omitted text keeps its current value and an empty string removes it (for a base-language text, back to the localized default). Works on published forms too, since texts never change what is stored for an answer. Changes go to the draft and are live once the form is published again.
readOnlyHint: false · destructiveHint: false · idempotentHint: true
formId string · required- Form id (GUID).
language string · required- The language these texts are in: "es" (Spanish), "en" (English) or "pt" (Portuguese). When it is the form's base language the texts are the form's own (title, submit button, thank-you and closed messages only); otherwise they are translations.
title string · optional- The form title in this language.
pages array · optional- Page titles in this language.
fields array · optional- Field texts in this language.
submitText string · optional- The submit button text in this language.
thankYouMessage string · optional- The default thank-you message in this language.
closedMessage string · optional- The message shown when the form is closed, in this language.
Modifies data
Duplicates a form as a new draft with its own public link, without copying submissions, email notifications or webhooks, and says so in the result. It's the way to change the locked fields of a published form.
Ask like this
Duplicate the order form so I can change its fields.
Technical details
Description the model receives:
Duplicates a form: the clone is a new Draft with a fresh public URL, copying the source's current draft (pages, fields, logic rules, texts, theme, PDF template). Email notifications, webhooks, integrations, approval settings, versions and submissions are not copied; the result says so. Because the clone has never been published, all of its fields are editable — cloning is the way to "edit" the locked fields of a published form without touching its existing submissions.
readOnlyHint: false · destructiveHint: false
formId string · required- Form id (GUID).
Modifies data
Publishes the draft so it can be filled out at its public link. If it was already published, the changes go live as a new version and submissions are kept.
Ask like this
Publish the registration form and give me the link.
Technical details
Description the model receives:
Publishes the form's current draft so it can be filled out at its public URL. Publishing an already-published form pushes the latest draft changes live as a new version; existing submissions are kept. Unless the form has an enabled email notification, each submission is emailed to the workspace owner.
readOnlyHint: false · destructiveHint: false
formId string · required- Form id (GUID).
set_pdf_template
Modifies data
Picks the PDF layout used when the form's submissions are exported. An unknown key returns the list of valid ones.
Ask like this
Use the “classic” PDF template for the order form.
Technical details
Description the model receives:
Sets the PDF layout used when this form's submissions are exported as PDF documents. Pass one of the catalog keys; an unknown key returns the list of valid ones.
readOnlyHint: false · destructiveHint: false · idempotentHint: true
formId string · required- Form id (GUID).
key string · required- PDF template key, e.g. "classic".
Destructive
Moves a form to the Trash: it stops accepting responses, but its submissions are kept and you can restore it from the app.
Ask like this
Move the test form to the trash.
Technical details
Description the model receives:
Moves a form to the Trash. The form disappears from lists and its public URL stops accepting responses, but nothing is destroyed: submissions are kept and the owner can restore the form from the Trash in the app. It no longer counts against the workspace's plan form limit while trashed.
readOnlyHint: false · destructiveHint: true
formId string · required- Form id (GUID).