> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supersonic.cv/llms.txt
> Use this file to discover all available pages before exploring further.

# Views

> Create list and board views with filters, sorting, and grouping.

Views are saved configurations for displaying records. A list view shows a table. A board view shows a kanban. Both support filters, sorting, column visibility, and grouping.

## Tools

| Tool           | Description                                     | Key Params                                                   |
| -------------- | ----------------------------------------------- | ------------------------------------------------------------ |
| `views.list`   | List all views in the workspace                 | `object_type_slug` (optional), `list_id` (optional)          |
| `views.get`    | Get a single view's configuration               | `view_id`                                                    |
| `views.create` | Create a new view                               | `name`, `object_type_slug`, `view_type`, `config`, `list_id` |
| `views.update` | Update a view's config (filters, sort, columns) | `view_id`, `config`                                          |
| `views.delete` | Delete a view                                   | `view_id`                                                    |
| `views.data`   | Fetch records using a view's saved config       | `view_id`, `page`, `page_size`                               |

### View Types

| Type    | Description                            |
| ------- | -------------------------------------- |
| `list`  | Table view with sortable columns       |
| `board` | Kanban board grouped by a select field |

## Examples

### Create a board view grouped by stage

```json theme={null}
{
  "tool": "views.create",
  "params": {
    "name": "Deal Board",
    "object_type_slug": "deals",
    "view_type": "board",
    "list_id": "lst_abc123",
    "config": {
      "group_by": "Stage",
      "columns": ["Name", "Deal Value", "Expected Close"],
      "sort": [{ "field": "Deal Value", "direction": "desc" }]
    }
  }
}
```

### Create a filtered list view

```json theme={null}
{
  "tool": "views.create",
  "params": {
    "name": "High-Value Open Deals",
    "object_type_slug": "deals",
    "view_type": "list",
    "list_id": "lst_abc123",
    "config": {
      "columns": ["Name", "Deal Value", "Stage", "Expected Close"],
      "filters": [
        { "field": "Deal Value", "operator": "gte", "value": 50000 },
        { "field": "Stage", "operator": "not_in", "value": ["Closed Won", "Closed Lost"] }
      ],
      "sort": [{ "field": "Deal Value", "direction": "desc" }]
    }
  }
}
```

### Fetch data through a view

```json theme={null}
{
  "tool": "views.data",
  "params": {
    "view_id": "view_xyz789",
    "page": 1,
    "page_size": 50
  }
}
```