Orgs Views

List groups (columns) for a view

Returns the board column descriptors (enum items, boolean buckets, date / number ranges, distinct strings) plus capability flags — reorderable_columns enables column-header DnD, movable_items enables card DnD between columns (only meaningful for enum / user / boolean axes), axis carries the resolved field for the FE header. No pagination — bounded by MAX_BOARD_COLUMNS. Throws 400 for kinds that have no groups (table / calendar / timeline).

GET

orgs

{org_id}

views

{view_id}

groups

List groups (columns) for a view

curl --request GET \
  --url https://api.useinvent.com/orgs/{org_id}/views/{view_id}/groups \
  --header 'Authorization: Bearer <token>'

{
  "groups": [
    {
      "key": "<string>",
      "type": "unmatched"
    }
  ],
  "capabilities": {
    "reorderable_columns": true,
    "movable_items": true,
    "axis": {
      "key": "<string>",
      "readonly": true,
      "sortable": true,
      "groupable_in": [],
      "kind": "scalar",
      "label": "<string>",
      "items": [
        {
          "value": "<string>",
          "label": "<string>",
          "description": "<string>",
          "icon_url": "<string>",
          "metadata": {
            "link": "<string>",
            "data": "<unknown>"
          }
        }
      ]
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer token authentication using your API key

Path Parameters

org_id

string

required

Org ID

view_id

string

required

View ID

Response

200 - application/json

groups

object[]

required

Show child attributes

capabilities

object

required

Show child attributes

Reorder a group (board column)Move a board column to a new position. Pass `group_key` for the column being moved and `after` / `before` for the neighbor group keys. The new full column order is persisted on `view.config.board.columns`. Returns the updated view.

List groups (columns) for a view

curl --request GET \
  --url https://api.useinvent.com/orgs/{org_id}/views/{view_id}/groups \
  --header 'Authorization: Bearer <token>'

{
  "groups": [
    {
      "key": "<string>",
      "type": "unmatched"
    }
  ],
  "capabilities": {
    "reorderable_columns": true,
    "movable_items": true,
    "axis": {
      "key": "<string>",
      "readonly": true,
      "sortable": true,
      "groupable_in": [],
      "kind": "scalar",
      "label": "<string>",
      "items": [
        {
          "value": "<string>",
          "label": "<string>",
          "description": "<string>",
          "icon_url": "<string>",
          "metadata": {
            "link": "<string>",
            "data": "<unknown>"
          }
        }
      ]
    }
  }
}