TablesWriteDo not retry automatically
Link rows across a relation
link_table_rowsSet, add to, remove from, or reorder the rows a relation cell points at. Links are membership, not a cell value, which is why update_table_row refuses a relation key. Cardinality and the per-cell cap are enforced by the write itself, so an over-link is refused rather than silently truncated. Rollups and lookups reading this relation are invalidated on BOTH tables.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tableId | string | required | Table holding the row being edited |
rowId | string | required | Row whose relation cell changes |
fieldKey | string | required | Relation field KEY on that table |
op | "add" | "remove" | "set" | "reorder" | required | add = link these as well; remove = unlink these; set = make the cell exactly this list (unlinking anything absent); reorder = keep the same links in this order |
targetRowIds | string[] | required | Row ids in the TARGET table |
Example call
The tool call an MCP client sends (required arguments shown with placeholder values).
{"tool": "link_table_rows","arguments": {"tableId": "tableId_123","rowId": "rowId_123","fieldKey": "value","op": "value","targetRowIds": "value"}}
Use this tool in
Claude CodeClaude DesktopClaude CoworkChatGPTCursorWindsurfVS Code CopilotOpenClawGeminiHermes Agent
Related Tables tools
List tables
list_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.