table-columns

Group columns

Create a column group over the given columns. They are pulled together at the leftmost member's position, keeping their current relative order, and the LAST member becomes the group's output: the column that stays visible when the group is collapsed. Groups are org-shared, like column order itself.

post/tables/{table_id}/columns/groups/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/tables/{table_id}/columns/groups/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

table_idstring uuid required

Request body

column_idsstring[] required

The columns to group; at least two, each currently ungrouped. They are pulled together at the leftmost member's position, keeping their current relative order. The LAST member becomes the group's output.

namestring nullable

The group's name; omit for the default label.

ui_color'gray' | 'red' | 'orange' | 'amber' | 'green' | 'blue' | 'purple' | 'pink'

Semantic tint token, shared by a column and by a column GROUP.

Stored as a token rather than a hex value because the grid renders in both a light and a dark theme, and a single stored colour is only legible in one of them. The client maps each token to a per-mode value.

Deliberately excludes teal: the brand primary is used for range selection and the anchor outline, so a teal column would read as permanently selected.

Lives HERE rather than in table_column_prefs, where it started, because two domains now need it and the layering only allows one direction. A column's tint is stored in table_column_prefs (org-shared appearance, keyed by column) while a group's is a field on the group row itself in table_column, and table_column_prefs sits ABOVE table_column in the domain layers, so the token had to move DOWN to be reachable from both. table_column_prefs.types re-exports it, which is why that move touched no existing import.

One enum for both on purpose: a colour token is a shared vocabulary (a team agreeing that amber means "needs review" is agreeing about it across columns and groups alike) and the organisation's renaming of the palette (table_column_color_labels) is keyed by this token, so a second enum would give groups colours the rename dialog could not name.

Response

Successful Response

collapsedboolean required

Whether the grid folds the group down to its output members. Purely presentational: folded members' cells are still fetched, so expanding costs nothing.

created_atstring date-time required
idstring uuid required
namestring nullable required

The group's name; null renders the client default label.

table_idstring uuid required
ui_color'gray' | 'red' | 'orange' | 'amber' | 'green' | 'blue' | 'purple' | 'pink' required

Semantic tint token, shared by a column and by a column GROUP.

Stored as a token rather than a hex value because the grid renders in both a light and a dark theme, and a single stored colour is only legible in one of them. The client maps each token to a per-mode value.

Deliberately excludes teal: the brand primary is used for range selection and the anchor outline, so a teal column would read as permanently selected.

Lives HERE rather than in table_column_prefs, where it started, because two domains now need it and the layering only allows one direction. A column's tint is stored in table_column_prefs (org-shared appearance, keyed by column) while a group's is a field on the group row itself in table_column, and table_column_prefs sits ABOVE table_column in the domain layers, so the token had to move DOWN to be reachable from both. table_column_prefs.types re-exports it, which is why that move touched no existing import.

One enum for both on purpose: a colour token is a shared vocabulary (a team agreeing that amber means "needs review" is agreeing about it across columns and groups alike) and the organisation's renaming of the palette (table_column_color_labels) is keyed by this token, so a second enum would give groups colours the rename dialog could not name.

updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.