Reorder column - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Use this endpoint when you want to move an existing column relative to its neighbors. Unlike create/projection endpoints, the request body here uses snake_case keys: after_column_id and before_column_id.

Both anchors are optional. Supply one to place before or after that column, or both to place between them. If neither is supplied, the legacy path leaves the position unchanged. The response contains success and position; it does not include the moved column ID.

Path parameters

table_idrequired
string
Target table ID.
column_idrequired
string
Target column ID.

Name	Type	Description
table_idrequired	string	Target table ID.
column_idrequired	string	Target column ID.

Body parameters

after_column_id · optional
string
Optional insertion anchor. Place the column after this column. Uses snake_case on this endpoint.
before_column_id · optional
string
Optional insertion anchor. Place the column before this column. Uses snake_case on this endpoint.

Name	Type	Description
after_column_id	string	Optional insertion anchor. Place the column after this column. Uses snake_case on this endpoint.
before_column_id	string	Optional insertion anchor. Place the column before this column. Uses snake_case on this endpoint.

Errors

Status	Meaning
401	Invalid API key or missing auth.
403	Missing columns:write scope or table access denied.
404	Column, table, or neighbor anchor not found.
422	The reorder body does not match its request model.

Example

bash

curl -X PATCH "https://app.autotouch.ai/api/tables/67bd8c39c7d3e80f0a95b560/columns/67bd8cd8c7d3e80f0a95b58f/position" \
    -H "Authorization: Bearer stk_your_key_id.your_secret" \
    -H "Content-Type: application/json" \
    -d '{
      "after_column_id":"67bd8cd8c7d3e80f0a95b58e",
      "before_column_id":"67bd8cd8c7d3e80f0a95b590"
    }'

Request body

json

{
    "after_column_id": "67bd8cd8c7d3e80f0a95b58e",
    "before_column_id": "67bd8cd8c7d3e80f0a95b590"
  }

Response example

json

{
    "success": true,
    "position": 4.5
  }