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.
crewship saved-view <subcommand> [flags]
saved-views, view.
Defined in cmd/crewship/cmd_admin_extras.go.
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. |
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. |
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.
Owner-only — the server returns 403 for non-owners.
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.
crewship saved-view delete sv_abc123
crewship saved-views delete sv_abc123 # alias
See also
