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

# Saved View

> Manage saved views — query bookmarks across issues / runs / activity.

# Saved View

Manage saved views — named, server-stored query bookmarks. A saved view captures the filters and sort you set in the web UI (across issues / runs / activity), persisted and addressable from the CLI.

```bash theme={null}
crewship saved-view <subcommand> [flags]
```

**Aliases:** `saved-views`, `view`.

<Note>
  Defined in `cmd/crewship/cmd_admin_extras.go`.
</Note>

## Subcommands

| Command            | Description                                         |
| ------------------ | --------------------------------------------------- |
| `list`             | List saved views.                                   |
| `create`           | Persist a new query bookmark.                       |
| `update <view-id>` | Patch a view (owner-only; only set flags are sent). |
| `delete <view-id>` | Remove a view.                                      |

***

## `crewship saved-view list`

`GET /api/v1/saved-views`. JSON-shaped output by default.

| Flag              | Type   | Default | Effect                           |
| ----------------- | ------ | ------- | -------------------------------- |
| `--filter <expr>` | string | (unset) | jq filter applied before output. |

```bash theme={null}
crewship saved-view list
crewship saved-view list --filter '.[] | {id, name, owner}'
crewship view list                              # alias
```

***

## `crewship saved-view create`

`POST /api/v1/saved-views`. Persists a query bookmark for the current user. `--filters` is the filter JSON the web UI stores; `--sort` is optional sort JSON. Both are validated as JSON client-side before the request is sent.

| Flag               | Type   | Default    | Effect                                   |
| ------------------ | ------ | ---------- | ---------------------------------------- |
| `--name <name>`    | string | (required) | View name.                               |
| `--filters <json>` | string | (required) | Filter JSON.                             |
| `--sort <json>`    | string | (unset)    | Sort JSON.                               |
| `--view-type <t>`  | string | `list`     | View type (server default `list`).       |
| `--shared`         | bool   | `false`    | Share the view with the whole workspace. |

```bash theme={null}
crewship saved-view create --name "My open issues" --filters '{"status":"open","assignee":"me"}'
crewship saved-view create --name "Team backlog" --filters '{"status":"backlog"}' --shared
```

***

## `crewship saved-view update <view-id>`

`PATCH /api/v1/saved-views/{id}`. Only the flags you set are sent. Accepts the same fields as `create` plus `--default` to mark the view as the default. `--filters`/`--sort` are JSON-validated client-side.

<Note>
  Owner-only — the server returns `403` for non-owners.
</Note>

```bash theme={null}
crewship saved-view update sv_abc123 --name "Renamed view"
crewship saved-view update sv_abc123 --default
```

***

## `crewship saved-view delete <view-id>`

`DELETE /api/v1/saved-views/{id}`. Prints `[deleted view <id>]` on success.

```bash theme={null}
crewship saved-view delete sv_abc123
crewship saved-views delete sv_abc123           # alias
```

## See also

* [`crewship issue`](/cli/issue) — most saved views target the issue tracker.
* [`crewship activity`](/cli/activity) — adjacent feed surface.