TablesWriteDo not retry automatically

Update a table field

update_table_field

Change one field: its name, description, icon, display format, per-kind configuration (select options, rating maximum …), whether it is required, or a formula’s source/preset. Changing `kind` CONVERTS the stored values — preview it first. A field bound to a resource contract may be relabelled and reformatted but never retyped.

Parameters

Parameter	Type	Required	Description
`tableId`	string	required	Table ID
`fieldId`	string	required	Field ID — get from get_table (fields[].id)
`label`	string	optional	Human-readable field name
`config`	object	optional	Per-kind configuration: { options: [{ id, label, color }] } for select/status, { maximum, icon } for rating, { multiple } for user, { prefix, digits } for auto number, { accept } for attachment.
`format`	object	optional	Display format — { kind: "number", variant: "currency", currency: "AUD", precision: 2 }, { kind: "date", preset: "medium" }. Presentation only; it never rewrites a stored value.
`required`	boolean	optional	Reject a row that leaves this field blank
`description`	string	optional	Shown in the column tooltip and the API
`icon`	string	optional	Icon catalog id, e.g. emoji:store
`kind`	"text" \| "long_text" \| "number" \| "checkbox" \| "date" \| "datetime" \| "single_select" \| "multi_select" \| "status" \| "url" \| "email" \| "phone" \| "rating" \| "user" \| "auto_number" \| "attachment" \| "json" \| "relation" \| "formula" \| "created_time" \| "last_edited_time" \| "created_by" \| "last_edited_by"	optional	Retype the field. Values that cannot be read as the new kind are cleared, so check first with preview_table_field_retype.
`source`	string	optional	New formula source (kind formula)
`preset`	object	optional	A structured computed field. Lowered to formula source server-side.
`expectedSchemaVersion`	integer	optional	Assert the table schema version you last read. Omit to let the call read it — the write still fails if someone changes the schema in between.

Example call

The tool call an MCP client sends (required arguments shown with placeholder values).

{
  "tool": "update_table_field",
  "arguments": {
    "tableId": "tableId_123",
    "fieldId": "fieldId_123"
  }
}

Use this tool in

Claude Code Claude Desktop Claude Cowork ChatGPT Cursor Windsurf VS Code Copilot OpenClaw Gemini Hermes Agent

Related Tables tools

List tableslist_tablesList the tables in the workspace (id, name, kind — typed or custom — resource type, fields, row count, schema/revision versions).Get tableget_tableGet one table by id: its full field set (key, label, kind, display format, select options, whether the field is feed-owned and whether it can be written), the fields that form row identity, the promoted primary/date/amount bindings, row count, and its schema badge.Create tablecreate_tableCreate a table in the workspace.Update tableupdate_tableUpdate a table’s METADATA — name, icon, retention policy.

← All tools