Getting started

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

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.

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.

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.

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.

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.

terminal
orc saved-views create --filter <value>

Examples

Save a named filter from a file.

terminal
orc saved-views create --stdin < saved-view.json

Save a named filter from a file.

See Manage measurement configuration and saved filters for combining measurement settings with saved conditions.

Global Options

The following global options can be used with orc saved-views:

For details and examples, see global options.