Skip to main content
POST
Reorder table columns

Authorizations

X-API-Key
string
header
required

Path Parameters

table_id
string<uuid>
required

Body

application/json

Request body for reordering a table's columns (full permutation).

column_ids
string<uuid>[]
required

Every column of the table exactly once, in the new display order.

Required array length: 1 - 100 elements
group_membership
TableColumnGroupMembershipSchema · object[]

Columns this reorder also moves in or out of a column group; columns left out keep the group they are in. This is how a drag that drops a column between two members of a group makes it a member: the new order and the new membership land together, so the group is never momentarily split. A group the list would leave with no member, or with no output, is refused rather than repaired.

Response

Successful Response

A table's columns in position order (non-paginated by design).

columns
TableColumnWithUIPrefsSchema · object[]
required
total_count
integer
required
groups
TableColumnGroupReadSchema · object[]

The table's column groups, membership resolved in position order.