TablesWriteRetry-safe

Set the field that names rows

set_table_primary_field

Designate which field NAMES a row: what a relation chip shows, what a relation picker searches, and what appears wherever a row is referred to. Must be a text-like field.

Parameters

Parameter	Type	Required	Description
`tableId`	string	required	Table ID
`fieldId`	string	required	Field ID to promote
`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": "set_table_primary_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