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

# Views (Bases)

> List, save, delete, and execute saved DQL views stored in .kiwi/views.

Base path: `http://localhost:3333/api/kiwi`.

## List views

```http theme={null}
GET /views
```

```json theme={null}
{ "views": [{ "name": "open-tasks", "query": "...", "layout": "table" }] }
```

## Get or save a view

```http theme={null}
GET /views/:name
```

Returns the full `View` object (`name`, `query`, `layout`, optional `columns`, `filters`, `sort`, `group_by`).

```http theme={null}
PUT /views/:name
Content-Type: application/json
```

Body is a `View` JSON object. The server forces `name` to match the URL parameter.

## Delete a view

```http theme={null}
DELETE /views/:name
```

Returns `{ "status": "deleted" }`.

## Execute a view

```http theme={null}
GET /views/:name/execute?limit=50&offset=0
```

Runs the view's DQL query through the Dataview executor, applies optional column formulas, and returns the query result payload (rows plus metadata from the executor).

Returns **`503`** if the Dataview executor is unavailable.

## MCP parity

See `kiwi_views_list`, `kiwi_views_get`, `kiwi_views_save`, `kiwi_views_delete`, and `kiwi_views_execute` in [MCP](/concepts/mcp).