table-columns

Update a column group

Rename a group, fold or expand it, or replace its membership wholesale. members is FULL-state: the entry order becomes the members' physical order, newly listed columns join the group, and current members left out are removed and land immediately after the block. A group always has at least one member and at least one output: an empty list is refused (ungroup to dissolve a group), and so is a list with no output flagged (mark another column as output first). Collapse and ui_color are purely presentational. Folded members' cells stay fetched, and a group's colour is its own, independent of any tint its member columns carry.

patch/tables/{table_id}/columns/groups/{group_id}/

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/{group_id}/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

table_idstring uuid required
group_idstring uuid required

Request body

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.