TablesWriteDo not retry automatically

Update a table view

update_table_view

Change a saved view’s name, icon, query (filter / sort / group), field arrangement, footer calculations, row colours, density or layout. Only the properties you pass change. A compare-and-set on the view version: another editor’s change is reported rather than overwritten. Another user’s personal view is not found.

Parameters

Parameter	Type	Required	Description
`tableId`	string	required	Table ID
`viewId`	string	required	View ID — from list_table_views
`name`	string	optional	Input for name.
`expectedVersion`	integer	optional	The view version you read. Omit to edit the version this call reads — pass it when a human is editing the same view.
`icon`	string \| null	optional	Icon catalog id; null clears it
`query`	object	optional	Which rows, in what order, grouped how: { filter, sort: [{ field, direction }], group: [{ field }] }. filter is the same tree query_table_rows takes, or null.
`fields`	object	optional	Field arrangement by key: { order, hidden, widths, pins: { left, right }, wrap }
`calculations`	object	optional	Footer calculation per field key, e.g. { amount: "sum" }
`decorations`	object \| object[]	optional	Row colour rules: [{ id, condition, color, style? }]; the first match wins
`density`	"comfortable" \| "compact" \| "tight"	optional	Input for density.
`layout`	unknown	optional	Layout: { layout: "grid" }, { layout: "board", groupField }, { layout: "calendar", dateField }, { layout: "gallery" }, { layout: "timeline", startField }, { layout: "list" } or { layout: "form" }. A board groups by a select, status, single user or one-row relation field.

Example call

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

{
  "tool": "update_table_view",
  "arguments": {
    "tableId": "tableId_123",
    "viewId": "viewId_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