---
title: saved-views
description: Save and inspect named query-filter views.
canonical_url: https://orchestor.io/docs/en/cli/saved-view
markdown_url: https://orchestor.io/docs/en/cli/saved-view.md
contentType: reference
---

# saved-views

`orc saved-views` saves a named JSON query-filter object and lists saved views. Use it to retain filters for reusing the same conditions.

CLI authentication and a selected Workspace are required. These are separate resources from `orc issues views`, which manages Issue layouts and shared defaults. Filter keys are not validated against report query parameters when saved; clients interpret them when applying the view.

## Usage

```bash title="terminal"
orc saved-views list --json
```

*List saved filters.*

## Subcommands

### `list`

Lists query-filter views saved in the current Workspace. Use `--limit` and `--cursor` for pagination.

```bash title="terminal"
orc saved-views list [options]
```

### `create`

Saves a view using `name` and a JSON object in `filter`. Names contain 1–120 characters after trimming. Send a complete JSON resource with `--stdin` to preserve nested filters.

```bash title="terminal"
orc saved-views create [options]
```

#### Unique options

##### `--idempotency-key`

Retry identity for operations that support idempotency. Use a unique key for each new operation, and reuse it only when retrying the same HTTP method, path, query values and exact request body. JSON whitespace changes can count as a different body. Keys contain 1–255 characters after trimming and expire after 24 hours. A completed JSON response is replayed without repeating the operation. A different request using the same key returns 409 idempotency_error. An in-progress request returns 409 idempotency_in_progress with Retry-After: 2. Whether this header is required depends on the operation.

Type: `string`. Optional.

```bash title="terminal"
orc saved-views create --idempotency-key <value>
```

##### `--name`

(required) Display name, trimmed on creation. Contains 1–120 characters after trimming.; max 120 chars

Type: `string`. Optional.

```bash title="terminal"
orc saved-views create --name <value>
```

##### `--filter`

(required) Stored query-filter object. Keys are not validated against report query parameters when saved; clients interpret the object when applying the view.; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc saved-views create --filter <value>
```

## Examples

### Save a named filter from a file.

```bash title="terminal"
orc saved-views create --stdin < saved-view.json
```

*Save a named filter from a file.*

## Related

See [Manage measurement configuration and saved filters](https://orchestor.io/docs/cli/workflows/measurement-configuration.md) for combining measurement settings with saved conditions.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc saved-views`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--limit`](https://orchestor.io/docs/cli/global-flags.md)
- [`--cursor`](https://orchestor.io/docs/cli/global-flags.md)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)