smartsuite_update_field
Update a field's label, params, or AI prompt in SmartSuite. Preview changes before applying, with selective merging of params and full replacement of choices for select fields.
Instructions
Update a field's label and/or params (any type). Requires readwrite/admin mode AND SMARTSUITE_ENABLE_SCHEMA_WRITE=true. params is a PATCH — only the keys you pass are changed (shallow-merged onto the existing params); everything else (choices, nested, links) is preserved. Read the field first with smartsuite_describe_field to see current params. Note: choices is replaced wholesale, not merged — to edit select options pass the FULL choices array (each choice may set value_help_text=description and weight=numeric value; colors auto-assigned if omitted). Applies asynchronously. Dry-run preview unless confirm:true. (For help text use smartsuite_set_field_help_text; for formula expressions use smartsuite_update_formula_field.) AI PROMPT: pass aiPrompt (plain text with {{field_slug}} references) to (re)build the field's dynamic AI instructions; it preserves the existing ai_agent model/settings and replaces only the prompt.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The field slug to update. | |
| label | No | New label (optional). | |
| params | No | Optional params patch (shallow-merged onto existing params). For select fields, omitted choice colors are auto-assigned. | |
| confirm | No | Must be true to apply (default false = preview). | |
| aiPrompt | No | Optional: rebuild the field's AI prompt. Plain-text with {{field_slug}} references; preserves existing ai_agent model/settings. | |
| applicationId | Yes | The application (table) ID. |