# viewGroups

Query

List user-created view groups for the current workspace, ordered oldest-first. Returns at most 1000 rows; this field is not paginated.

Available to agents as MCP tool `getViewGroups` — see [Read tools](/api/v2/docs/mcp/read-tools#get-view-groups).

## Arguments

This field takes no arguments.

## Returns

Returns [`[ViewGroup!]!`](/api/v2/docs/types/view-group).

## Examples

### List view groups

Return the workspace's user-created view groups, oldest first.

```graphql
query ViewGroupsDefault {
  viewGroups {
    id
    name
    createdAt
    updatedAt
  }
}
```

Response — HTTP 200:

```json
{
  "data": {
    "viewGroups": [
      {
        "id": "8e0f0ff1-8024-5af5-9506-49091f53a920",
        "name": "Northwind Sidebar",
        "createdAt": "2024-12-31T17:00:00Z",
        "updatedAt": "2024-12-31T17:00:00Z"
      }
    ]
  }
}
```