TablesWriteDo not retry automatically

Link rows across a relation

link_table_rows

Set, 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

ParameterTypeRequiredDescription
tableIdstringrequiredTable holding the row being edited
rowIdstringrequiredRow whose relation cell changes
fieldKeystringrequiredRelation field KEY on that table
op"add" | "remove" | "set" | "reorder"requiredadd = 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
targetRowIdsstring[]requiredRow 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

Related Tables tools