update_frozen_column_count
Idempotent
Set the leftmost columns in a grid view to remain visible when scrolling horizontally. Controls how many columns are frozen from the left, with 0 unfreezing all.
Instructions
Set the frozen-column divider position for a grid view. The first N columns from the left are frozen and stay visible during horizontal scroll.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | The Airtable base/application ID | |
| viewId | Yes | The view ID | |
| frozenColumnCount | Yes | Number of columns to freeze (counted from the left). 0 unfreezes all. | |
| debug | No | When true, include raw Airtable response in output for diagnostics |
Implementation Reference
- Tool schema definition for 'update_frozen_column_count' — input schema with appId, viewId, frozenColumnCount, and debug properties.
{ name: 'update_frozen_column_count', description: 'Set the frozen-column divider position for a grid view. The first N columns from the left are frozen and stay visible during horizontal scroll.', annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }, inputSchema: { type: 'object', properties: { appId: { type: 'string', description: 'The Airtable base/application ID' }, viewId: { type: 'string', description: 'The view ID' }, frozenColumnCount: { type: 'number', description: 'Number of columns to freeze (counted from the left). 0 unfreezes all.' }, debug: debugProp, }, required: ['appId', 'viewId', 'frozenColumnCount'], }, }, - Handler function that calls client.updateFrozenColumnCount() and returns the result.
async update_frozen_column_count({ appId, viewId, frozenColumnCount, debug }) { const result = await client.updateFrozenColumnCount(appId, viewId, frozenColumnCount); return ok({ updated: true, viewId, frozenColumnCount }, result, debug); }, - AirtableClient.updateFrozenColumnCount() — sends POST to /v0.3/view/{viewId}/updateFrozenColumnCount with the frozenColumnCount payload.
/** Update the frozen-column divider position for a grid view. */ async updateFrozenColumnCount(appId, viewId, frozenColumnCount) { assertAirtableId(appId, 'appId'); assertAirtableId(viewId, 'viewId'); const url = `https://airtable.com/v0.3/view/${viewId}/updateFrozenColumnCount`; const payload = { frozenColumnCount: Number(frozenColumnCount) }; const res = await this.auth.postForm(url, this._mutationParams(payload, appId), appId); if (!res.ok) { const errBody = await res.text().catch(() => ''); throw new Error(`updateFrozenColumnCount failed (${res.status}): ${errBody}`); } return res.json(); } - packages/mcp-server/src/tool-config.js:73-73 (registration)Tool profile category registration: categorized as 'view-write'.
update_frozen_column_count: 'view-write', - packages/extension/src/mcp/tool-profile.ts:80-80 (registration)Extension-side tool profile category registration: categorized as 'view-write'.
update_frozen_column_count:'view-write',