TablesWriteRetry-safe

Update table

update_table

Update a table’s METADATA — name, icon, retention policy. Grid arrangement lives on views (see list_table_views / update_table_view), never on the table. Fields are deliberately not editable here: a schema change is a compare-and-set operation against a version this surface cannot hold safely, so field edits and typed→custom conversion belong to the table editor.

Parameters

Parameter	Type	Required	Description
`tableId`	string	required	Table ID — get from list_tables
`name`	string	optional	New name
`icon`	string	optional	New emoji
`retention`	object	optional	Row retention, e.g. { mode: "forever" } or { mode: "days", days: 365 }. Rows older than the window are purged by the maintenance workflow, so `days` must be between 1 and 3650 — there is deliberately no "keep nothing" policy.

Example call

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

{
  "tool": "update_table",
  "arguments": {
    "tableId": "tableId_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.Delete tabledelete_tableMove a table to the trash.

← All tools