TablesWriteRetry-safe

Reorder a table field

move_table_field

Move a field to a new position. Position is the column ORDER a person sees; it changes no stored value and no field key.

Parameters

ParameterTypeRequiredDescription
tableIdstringrequiredTable ID
fieldIdstringrequiredField ID
positionintegerrequiredZero-based target position
expectedSchemaVersionintegeroptionalAssert 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": "move_table_field",
"arguments": {
"tableId": "tableId_123",
"fieldId": "fieldId_123",
"position": 0
}
}

Use this tool in

Related Tables tools