asksteps: replace an existing form
asksteps_update_formIdempotent
Replaces an existing form of the connected asksteps account. Requires "forms:write". IMPORTANT: this REPLACES the whole form — every step and field you do not send is gone. Call asksteps_get_form first, change what the user asked for, and send the result back complete. Forms built from a PDF and forms containing elements this format cannot describe are refused; the answer says which and why. The publication state is never changed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spec | Yes | The complete new content of the form. Anything omitted is deleted. | |
| form_id | Yes | The form id, as returned by asksteps_list_forms or asksteps_get_form. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Link that opens the form in the asksteps studio. Give it to the user so they can look at the result. Absolute when this deployment knows its public base URL, otherwise a site-relative path; never invent the domain part. | |
| note | Yes | One sentence for the user. On rejection it says exactly what to fix. | |
| formId | No | The id of the form. Keep it — it is how you read or change the form later. | |
| status | Yes | Outcome. One of: "created", "updated", "not_connected", "not_found", "invalid_spec" (the structure was rejected — the note says exactly what to fix), "not_editable" (this form cannot be written from a spec), "unavailable", "error". Authorisation can also refuse before the tool runs: "plan_required" (the account's plan does not include agent access), "not_enabled" (the account owner has not switched agent access on), "owner_required" (only the account owner may do this), "mandate_required" (the owner has not granted a mandate for this). The note then says what the user has to do. | |
| stepCount | No | Number of steps the form ended up with. | |
| fieldCount | No | Total number of fields across all steps. |