TablesWriteDo not retry automatically

Delete a table field

delete_table_field

Remove a field from a table. The field is tombstoned and its key is never reused, so the values under it can never resurface under a later field with the same name. Refused for the primary field (designate another first) and for a field a formula or rollup still reads.

Parameters

ParameterTypeRequiredDescription
tableIdstringrequiredTable ID
fieldIdstringrequiredField ID — get from get_table
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": "delete_table_field",
"arguments": {
"tableId": "tableId_123",
"fieldId": "fieldId_123"
}
}

Use this tool in

Related Tables tools