Update column layout - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

The endpoint persists the user-facing layout and emits a table update; it does not rewrite storage positions. Table-not-found is returned as 404. Unknown IDs are omitted, duplicate IDs are deduplicated, and storage columns not named in either list are appended in storage order. The stored layout includes version, visible_column_ids, hidden_column_ids, source, user_customized, and updated_at; updated_by is included when available.

Path parameters

table_idrequired
string
Research Table ID.

Name	Type	Description
table_idrequired	string	Research Table ID.

Body parameters

visibleColumnIds · optional
array<string>
Visible column IDs in display order; defaults to [].
hiddenColumnIds · optional
array<string>|null
Optional hidden column IDs.

Name	Type	Description
visibleColumnIds	array<string>	Visible column IDs in display order; defaults to [].
hiddenColumnIds	array<string>\|null	Optional hidden column IDs.

Errors

Status	Meaning
401	Authentication is required.
403	The caller lacks access to the resource or the columns:write scope.
422	The request does not satisfy the route or typed request contract.

Example

bash

curl -X PATCH "https://app.autotouch.ai/api/tables/68d2c6a1a833d60619000001/columns/layout" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "visibleColumnIds": ["68d2c6a1a833d60619000001", "68d2c6a1a833d60619000002"],
  "hiddenColumnIds": []
}'

Request body

json

{
  "visibleColumnIds": ["68d2c6a1a833d60619000001", "68d2c6a1a833d60619000002"],
  "hiddenColumnIds": []
}

Response example

json

{
  "success": true,
  "layout": {"version": 1, "visible_column_ids": ["68d2c6a1a833d60619000001", "68d2c6a1a833d60619000002"], "hidden_column_ids": [], "source": "user", "user_customized": true, "updated_at": "2026-09-27T12:00:00"}
}