From 8646ab97ff7329682bf91aae8ef9a6abfd527d10 Mon Sep 17 00:00:00 2001 From: Sava Znatnov Date: Sat, 10 Oct 2026 23:58:30 +0700 Subject: [PATCH] feat!: a command that grants access asks first, and its tool asks for a person An operation that lets someone at data they could not reach says so beside its effect, `grants_access=True`, in its `endpoints.py`. Fourteen do today: access to a form and to a Wiki page, permissions of a Tracker queue and of an entity, access bindings of a DataLens workbook, collection and shared entry, the assignment of a licence, an embedding and its key (#556). Nothing else names them: no list of operations exists. From that one mark: - the CLI asks before it sends such a request, as before a delete, in words of its own ("this grants access"); `--yes` skips the question, and with no terminal the command exits 2 and says to pass `--yes`. `--dry-run` asks nothing. The help of the command says it. - the tool carries `_meta["anthropic/requiresUserInteraction"]`, which Claude Code answers by asking a person on every call, in every permission mode, and by denying the call where nobody can be asked. Its description says so in words for clients that do not read the key. Under `--tool-search` such a tool stays in the listing by its own name, with its mark, and the proxy that runs what the search found refuses it: behind the proxy there would be no entry for a client to read the mark from. - the SDK asks whoever gave it a `confirm`, and nobody otherwise. The three Tracker permission updates ask even when the body only takes rights away: the mark is of the operation. ARCH-3 holds it honest the way it holds effects: the contract test compares the mark of every tool with what its operation says, both ways, and the help of every command with the mark of its tool. BREAKING CHANGE: the fourteen commands that grant access ask for confirmation. A script that called one without a terminal now exits 2: before: ycli wiki access create 7 --role reader --user-uid 9001 after: ycli wiki access create 7 --role reader --user-uid 9001 --yes Co-Authored-By: Claude Opus 5.5 --- .agents/skills/yandex-360/SKILL.md | 7 +- .claude/skills/yandex-360/SKILL.md | 7 +- .opencode/skills/yandex-360/SKILL.md | 7 +- ARCHITECTURE.md | 9 +- docs/en/how-to/script-the-cli.md | 7 +- docs/en/how-to/use-in-ci.md | 2 +- docs/en/reference/cli/auth.md | 4 +- docs/en/reference/cli/datalens.md | 284 +++++++------ docs/en/reference/cli/forms.md | 174 ++++---- docs/en/reference/cli/index.md | 2 +- docs/en/reference/cli/mcp.md | 4 +- docs/en/reference/cli/sync.md | 12 +- docs/en/reference/cli/tracker.md | 391 +++++++++--------- docs/en/reference/cli/wiki.md | 124 +++--- docs/en/reference/mcp/datalens.md | 14 + docs/en/reference/mcp/forms.md | 4 + docs/en/reference/mcp/tracker.md | 6 + docs/en/reference/mcp/wiki.md | 4 + docs/ru/how-to/script-the-cli.md | 7 +- docs/ru/how-to/use-in-ci.md | 2 +- plugins/yandex-360/skills/yandex-360/SKILL.md | 7 +- src/ycli/cli/api.py | 2 + src/ycli/cli/guard.py | 13 +- src/ycli/cli/typedefs.py | 4 +- src/ycli/mcp/listing.py | 35 +- src/ycli/mcp/server.py | 72 +++- src/ycli/yandex/core/endpoint.py | 8 +- src/ycli/yandex/core/guard.py | 24 +- src/ycli/yandex/datalens/collections/cli.py | 5 +- .../yandex/datalens/collections/endpoints.py | 8 +- src/ycli/yandex/datalens/collections/mcp.py | 2 + src/ycli/yandex/datalens/dependencies.py | 2 + .../yandex/datalens/embeddingsecrets/cli.py | 2 + .../datalens/embeddingsecrets/endpoints.py | 8 +- .../yandex/datalens/embeddingsecrets/mcp.py | 10 +- src/ycli/yandex/datalens/embeds/cli.py | 10 +- src/ycli/yandex/datalens/embeds/endpoints.py | 4 +- src/ycli/yandex/datalens/embeds/mcp.py | 13 +- src/ycli/yandex/datalens/licensing/cli.py | 5 +- .../yandex/datalens/licensing/endpoints.py | 4 +- src/ycli/yandex/datalens/licensing/mcp.py | 5 +- src/ycli/yandex/datalens/sharedentries/cli.py | 5 +- .../datalens/sharedentries/endpoints.py | 8 +- src/ycli/yandex/datalens/sharedentries/mcp.py | 2 + src/ycli/yandex/datalens/workbooks/cli.py | 5 +- .../yandex/datalens/workbooks/endpoints.py | 8 +- src/ycli/yandex/datalens/workbooks/mcp.py | 2 + src/ycli/yandex/errors.py | 2 +- src/ycli/yandex/forms/access/cli.py | 10 +- src/ycli/yandex/forms/access/endpoints.py | 8 +- src/ycli/yandex/forms/access/mcp.py | 3 + src/ycli/yandex/forms/dependencies.py | 2 + src/ycli/yandex/mcp.py | 7 + src/ycli/yandex/tracker/dependencies.py | 2 + src/ycli/yandex/tracker/entities/cli.py | 9 +- src/ycli/yandex/tracker/entities/endpoints.py | 8 +- src/ycli/yandex/tracker/entities/mcp.py | 3 + src/ycli/yandex/tracker/queues/cli.py | 3 + src/ycli/yandex/tracker/queues/endpoints.py | 6 +- src/ycli/yandex/tracker/queues/mcp.py | 2 + src/ycli/yandex/wiki/access/cli.py | 7 +- src/ycli/yandex/wiki/access/endpoints.py | 9 +- src/ycli/yandex/wiki/access/mcp.py | 8 +- src/ycli/yandex/wiki/dependencies.py | 2 + tests/contract/__init__.py | 31 ++ tests/contract/test_contract.py | 24 +- tests/contract/test_output_formats.py | 7 +- tests/unit/cli/test_cli_guard.py | 82 ++++ tests/unit/mcp/test_mcp_listing.py | 35 +- tests/unit/mcp/test_mcp_selection.py | 54 ++- tests/unit/yandex/core/test_guard.py | 30 ++ .../unit/yandex/tracker/entities/test_cli.py | 2 +- tests/unit/yandex/wiki/test_cli.py | 4 +- 73 files changed, 1146 insertions(+), 558 deletions(-) diff --git a/.agents/skills/yandex-360/SKILL.md b/.agents/skills/yandex-360/SKILL.md index f946b606b..52b153d68 100644 --- a/.agents/skills/yandex-360/SKILL.md +++ b/.agents/skills/yandex-360/SKILL.md @@ -113,9 +113,12 @@ semantics, a service ycli does not wrap yet), read the official docs directly, a - **Never hardcode the token or org id** — always read them from the environment. - **Respect the MCP annotations** — write tools declare `readOnlyHint=False`; anything - with `destructiveHint=true` deletes data, so confirm intent before calling it. If the + with `destructiveHint=true` deletes data, so confirm intent before calling it. A tool that + grants access (a role, a permission, an access binding, an embedding) says so in its + description and is marked so that the client asks a person on every call; where nobody can + be asked the call is denied, and the CLI with `--yes` is the way, after the user agreed. If the session must not write at all, run the server with `ycli mcp start --read-only`. -- **CLI deletes ask first** — a command that deletes data prompts on a terminal and, without +- **CLI deletes and grants ask first** — a command that deletes data or grants access prompts on a terminal and, without one (an agent's shell), exits 2 unless given `--yes`; confirm intent with the user before adding it. `--dry-run` prints the write request instead of sending it, the JSON result pipes to `jq`, and the exit code says what failed (3 not found, 4 auth, 5 rate limited, diff --git a/.claude/skills/yandex-360/SKILL.md b/.claude/skills/yandex-360/SKILL.md index dbd74d9a5..c89fbc46d 100644 --- a/.claude/skills/yandex-360/SKILL.md +++ b/.claude/skills/yandex-360/SKILL.md @@ -115,9 +115,12 @@ semantics, a service ycli does not wrap yet), read the official docs directly, a - **Never hardcode the token or org id** — always read them from the environment. - **Respect the MCP annotations** — write tools declare `readOnlyHint=False`; anything - with `destructiveHint=true` deletes data, so confirm intent before calling it. If the + with `destructiveHint=true` deletes data, so confirm intent before calling it. A tool that + grants access (a role, a permission, an access binding, an embedding) says so in its + description and is marked so that the client asks a person on every call; where nobody can + be asked the call is denied, and the CLI with `--yes` is the way, after the user agreed. If the session must not write at all, run the server with `ycli mcp start --read-only`. -- **CLI deletes ask first** — a command that deletes data prompts on a terminal and, without +- **CLI deletes and grants ask first** — a command that deletes data or grants access prompts on a terminal and, without one (an agent's shell), exits 2 unless given `--yes`; confirm intent with the user before adding it. `--dry-run` prints the write request instead of sending it, the JSON result pipes to `jq`, and the exit code says what failed (3 not found, 4 auth, 5 rate limited, diff --git a/.opencode/skills/yandex-360/SKILL.md b/.opencode/skills/yandex-360/SKILL.md index dbd74d9a5..c89fbc46d 100644 --- a/.opencode/skills/yandex-360/SKILL.md +++ b/.opencode/skills/yandex-360/SKILL.md @@ -115,9 +115,12 @@ semantics, a service ycli does not wrap yet), read the official docs directly, a - **Never hardcode the token or org id** — always read them from the environment. - **Respect the MCP annotations** — write tools declare `readOnlyHint=False`; anything - with `destructiveHint=true` deletes data, so confirm intent before calling it. If the + with `destructiveHint=true` deletes data, so confirm intent before calling it. A tool that + grants access (a role, a permission, an access binding, an embedding) says so in its + description and is marked so that the client asks a person on every call; where nobody can + be asked the call is denied, and the CLI with `--yes` is the way, after the user agreed. If the session must not write at all, run the server with `ycli mcp start --read-only`. -- **CLI deletes ask first** — a command that deletes data prompts on a terminal and, without +- **CLI deletes and grants ask first** — a command that deletes data or grants access prompts on a terminal and, without one (an agent's shell), exits 2 unless given `--yes`; confirm intent with the user before adding it. `--dry-run` prints the write request instead of sending it, the JSON result pipes to `jq`, and the exit code says what failed (3 not found, 4 auth, 5 rate limited, diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 4298acf54..abb1c5f1c 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -143,11 +143,18 @@ program stays a test. `POST`), the effect is always named: `RPC(name, …, effect=…)` has no default for it. A tool states its annotations only: the root server derives its tags, the service from the name and `write` from `readOnlyHint`. + An operation that lets someone at data they could not reach (a role, a permission, a + licence, an embedding) says so beside its effect, `grants_access=True`: from that one mark + the CLI asks before it sends it, as before a delete, and the tool carries + `_meta["anthropic/requiresUserInteraction"]` (`GRANTS_ACCESS`), which a client that honours + it answers by asking a person on every call. No list of such operations exists anywhere. - **Why:** agents and their hosts decide what to auto-approve from these hints; the MCP default for an unannotated tool is "destructive". - **Check:** the contract test (`tests/contract/test_contract.py`, one case per way of reaching an operation, fail-closed both ways) runs every tool and compares its hints with the strongest - effect of the endpoints it sends; `test_arch3_effect_overrides_are_marked` keeps + effect of the endpoints it sends, and its `GRANTS_ACCESS` mark with whether one of them grants + access, both ways; `test_the_help_of_a_command_says_it_grants_access_where_its_tool_is_marked` + holds the command's help to the same mark; `test_arch3_effect_overrides_are_marked` keeps `# violation(arch-3): ` above every `effect=`, and every such marker above one; `test_arch3_write_tools_carry_write_tag` keeps `--read-only` complete over the served tools, and the ast-grep rule `no-tool-tags` keeps a second statement out. `status_get`, the one diff --git a/docs/en/how-to/script-the-cli.md b/docs/en/how-to/script-the-cli.md index 338e1a792..f225b168d 100644 --- a/docs/en/how-to/script-the-cli.md +++ b/docs/en/how-to/script-the-cli.md @@ -71,14 +71,17 @@ $ ycli tracker issues search 'Queue: DE' --limit 100 --next eyJ2IjoxLCJvZiI6… A token carries its listing: with `--next`, give nothing but the limit and what the command cannot be called without, and that as it was: an argument that differs from the token's is refused by its name, never passed over. A token of a Tracker issue search by a scroll (`--scroll-type`) works once; any other token works again. It also holds the scroll's own token, so `ycli tracker issues scroll-clear --next TOKEN` releases the scroll before it expires; that token is of no use without your credentials and dies with the scroll. A token goes on only in the organization it was returned in: under another account it is refused, not run. A listing that can no longer go on exits with `9`: start it again without the token. A run that asks more pages than `YCLI__HTTP__MAX_PAGES` stops there and says so the same way, with a token to go on from. A small first `--limit` sets the size of the pages for every piece after it, so take the first piece as large as the ones you mean to go on with. -## Delete without a prompt +## Delete or grant access without a prompt -A command that destroys data asks for confirmation at a terminal. In a script there is no one to ask, so it fails with exit code 2 until you pass `--yes` / `-y`: +A command that destroys data, or that grants access (a role on a form or a page, permissions of a queue, an access binding or an embedding in DataLens), asks for confirmation at a terminal. In a script there is no one to ask, so it fails with exit code 2 until you pass `--yes` / `-y`: ```bash ycli tracker boards delete 7 --yes +ycli wiki access create 7 --role reader --user-uid 9001 --yes ``` +The help of a command that grants access says so. `--dry-run` asks nothing: it sends nothing. + ## Preview a write `--dry-run` sends no write and prints the request instead (method, URL, body, never the token), through the same `-o`, and exits 0. A secret in the body, such as the password of a DataLens connection, is printed as `***`, so the output is safe in a CI log. Give such a value from a file outside the repository, mode 600: in `--body-file`, or as one field with `-F password=@secret.txt`. Typed on a command line it stays in the shell history. Write the file of one field with no line break at its end (`printf %s 'secret' > secret.txt`), or the break goes out with the secret. Reads still run, so a command that reads and then writes shows only its first write. diff --git a/docs/en/how-to/use-in-ci.md b/docs/en/how-to/use-in-ci.md index 102440641..64aef6ae0 100644 --- a/docs/en/how-to/use-in-ci.md +++ b/docs/en/how-to/use-in-ci.md @@ -61,7 +61,7 @@ docker run --rm -e YANDEX_ID_OAUTH_TOKEN -e YANDEX_ID_ORGANIZATION_ID \ ## Commands that do not wait -- **Deletes need `--yes`.** A command that destroys data asks for confirmation; with no terminal it exits with code 2 instead. Pass `--yes` when the pipeline is meant to delete. +- **Deletes and grants need `--yes`.** A command that destroys data, or that grants access (a role on a form or a page, permissions of a queue or an entity, an access binding, a licence or an embedding in DataLens), asks for confirmation; with no terminal it exits with code 2 instead. Pass `--yes` when the pipeline is meant to do it. The help of a command that grants access says so. - **Output is JSON.** Without a terminal ycli prints JSON, so `jq` reads it: `ycli tracker issues get TRACKER-1 | jq .key`. - **Try it first.** `--dry-run` prints the request a write would send and sends nothing. diff --git a/docs/en/reference/cli/auth.md b/docs/en/reference/cli/auth.md index 404bcefd7..4703a084f 100644 --- a/docs/en/reference/cli/auth.md +++ b/docs/en/reference/cli/auth.md @@ -42,7 +42,7 @@ $ ycli auth status [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -94,7 +94,7 @@ $ ycli auth profiles [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. diff --git a/docs/en/reference/cli/datalens.md b/docs/en/reference/cli/datalens.md index 07bcb2cdf..b4c9a4d7a 100644 --- a/docs/en/reference/cli/datalens.md +++ b/docs/en/reference/cli/datalens.md @@ -82,7 +82,7 @@ $ ycli datalens auth status [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -120,7 +120,7 @@ $ ycli datalens tenant details-get [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -175,7 +175,7 @@ $ ycli datalens collections get [OPTIONS] COLLECTION_ID * `--include-permissions-info / --no-include-permissions-info`: Also say what you may do with it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -199,7 +199,7 @@ $ ycli datalens collections list-by-ids [OPTIONS] COLLECTION_ID... **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -232,7 +232,7 @@ $ ycli datalens collections content-list [OPTIONS] [COLLECTION_ID] * `--mode TEXT`: Which kinds of items to list. Known values: all, onlyCollections, onlyWorkbooks, onlyEntries. * `--include-permissions-info / --no-include-permissions-info`: Also say what you may do with it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -257,7 +257,7 @@ $ ycli datalens collections breadcrumbs-list [OPTIONS] COLLECTION_ID * `--include-permissions-info / --no-include-permissions-info`: Also say what you may do with it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -277,7 +277,7 @@ $ ycli datalens collections permissions-get-root [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -305,7 +305,7 @@ $ ycli datalens collections access-bindings-list [OPTIONS] COLLECTION_ID * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `--get-inherited-bindings / --no-get-inherited-bindings`: Also list the inherited roles. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -328,7 +328,7 @@ $ ycli datalens collections create [OPTIONS] * `--parent-id TEXT`: The collection to put it in; the root when left out. * `--description TEXT`: Description of the collection. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -354,7 +354,7 @@ $ ycli datalens collections update [OPTIONS] COLLECTION_ID * `--title TEXT`: New title. * `--description TEXT`: New description. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -380,7 +380,7 @@ $ ycli datalens collections move [OPTIONS] COLLECTION_ID * `--parent-id TEXT`: The collection to put it in; the root when left out. * `--title TEXT`: New title to give it on the way. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -405,7 +405,7 @@ $ ycli datalens collections move-bulk [OPTIONS] COLLECTION_ID... * `--parent-id TEXT`: The collection to put it in; the root when left out. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -429,7 +429,7 @@ $ ycli datalens collections delete [OPTIONS] COLLECTION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -453,7 +453,7 @@ $ ycli datalens collections delete-bulk [OPTIONS] COLLECTION_ID... **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -464,6 +464,8 @@ $ ycli datalens collections delete-bulk [OPTIONS] COLLECTION_ID... Give or take away roles on a collection; the roles not named stay as they are. +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -478,7 +480,7 @@ $ ycli datalens collections access-bindings-update [OPTIONS] COLLECTION_ID * `--delta TEXT`: A role to add or remove, as a JSON object of the API docs: {"action": "ADD", "accessBinding": {"roleId": ..., "subject": {"id": ..., "type": ...}}} (repeatable). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -532,7 +534,7 @@ $ ycli datalens workbooks get [OPTIONS] WORKBOOK_ID * `--include-permissions-info / --no-include-permissions-info`: Also say what you may do with it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -561,7 +563,7 @@ $ ycli datalens workbooks list [OPTIONS] * `--only-my / --no-only-my`: Keep only what you created. * `--include-permissions-info / --no-include-permissions-info`: Also say what you may do with it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -585,7 +587,7 @@ $ ycli datalens workbooks list-by-ids [OPTIONS] WORKBOOK_ID... **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -613,7 +615,7 @@ $ ycli datalens workbooks access-bindings-list [OPTIONS] WORKBOOK_ID * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `--get-inherited-bindings / --no-get-inherited-bindings`: Also list the inherited roles. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -646,7 +648,7 @@ $ ycli datalens workbooks entries-list [OPTIONS] WORKBOOK_ID * `--order-by TEXT`: What to sort by, as a JSON object: {"field": "name", "direction": "asc"}. * `--filters TEXT`: A filter, as a JSON object: {"name": "sales"}. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -669,7 +671,7 @@ $ ycli datalens workbooks create [OPTIONS] * `--collection-id TEXT`: The collection to put it in; the root when left out. * `--description TEXT`: Description of the workbook. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -695,7 +697,7 @@ $ ycli datalens workbooks update [OPTIONS] WORKBOOK_ID * `--title TEXT`: New title. * `--description TEXT`: New description. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -721,7 +723,7 @@ $ ycli datalens workbooks move [OPTIONS] WORKBOOK_ID * `--collection-id TEXT`: The collection to put it in; the root when left out. * `--title TEXT`: New title to give it on the way. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -746,7 +748,7 @@ $ ycli datalens workbooks move-bulk [OPTIONS] WORKBOOK_ID... * `--collection-id TEXT`: The collection to put it in; the root when left out. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -770,7 +772,7 @@ $ ycli datalens workbooks delete [OPTIONS] WORKBOOK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -794,7 +796,7 @@ $ ycli datalens workbooks delete-bulk [OPTIONS] WORKBOOK_ID... **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -805,6 +807,8 @@ $ ycli datalens workbooks delete-bulk [OPTIONS] WORKBOOK_ID... Give or take away roles on a workbook; the roles not named stay as they are. +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -819,7 +823,7 @@ $ ycli datalens workbooks access-bindings-update [OPTIONS] WORKBOOK_ID * `--delta TEXT`: A role to add or remove, as a JSON object of the API docs: {"action": "ADD", "accessBinding": {"roleId": ..., "subject": {"id": ..., "type": ...}}} (repeatable). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -867,7 +871,7 @@ $ ycli datalens entrylocks create [OPTIONS] ENTRY_ID * `--data TEXT`: The terms of the lock, as a JSON object: {"duration": 300000, "force": false} (the duration in milliseconds). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -892,7 +896,7 @@ $ ycli datalens entrylocks extend [OPTIONS] ENTRY_ID * `--data TEXT`: The lock and its new terms, as a JSON object: {"lockToken": "...", "duration": 600000}. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -917,7 +921,7 @@ $ ycli datalens entrylocks delete [OPTIONS] ENTRY_ID * `--params TEXT`: Which lock to release, as a JSON object: {"lockToken": "..."}, or {"force": true} for a lock held by another. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -967,7 +971,7 @@ $ ycli datalens sparkclusters list [OPTIONS] * `--collection-id TEXT`: Keep the clusters of one collection. * `--filter TEXT`: A filter expression of the API (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -991,7 +995,7 @@ $ ycli datalens sparkclusters get [OPTIONS] CLUSTER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1020,7 +1024,7 @@ $ ycli datalens sparkclusters create [OPTIONS] * `--description TEXT`: A description of the cluster. * `--labels TEXT`: Labels, as a JSON object: {"team": "bi"}. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1044,7 +1048,7 @@ $ ycli datalens sparkclusters delete [OPTIONS] CLUSTER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1068,7 +1072,7 @@ $ ycli datalens sparkclusters start [OPTIONS] CLUSTER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1092,7 +1096,7 @@ $ ycli datalens sparkclusters stop [OPTIONS] CLUSTER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1116,7 +1120,7 @@ $ ycli datalens sparkclusters resource-presets-list [OPTIONS] * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1141,7 +1145,7 @@ $ ycli datalens sparkclusters resource-presets-get [OPTIONS] RESOURCE_PRESET_ID * `--cloud-environment-id TEXT`: The cloud environment the presets are for. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1191,7 +1195,7 @@ $ ycli datalens htmlpages get [OPTIONS] ENTRY_ID * `--include-permissions / --no-include-permissions`: Also say what you may do with the page. * `--include-favorite / --no-include-favorite`: Also say whether the page is a favourite. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1219,7 +1223,7 @@ $ ycli datalens htmlpages create [OPTIONS] * `--workbook-id TEXT`: The workbook to create the page in. * `--name TEXT`: The page's name. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1250,7 +1254,7 @@ $ ycli datalens htmlpages update [OPTIONS] ENTRY_ID * `--rev-id TEXT`: A revision to make current, in place of new content. * `--annotation TEXT`: A description of the page, as JSON: {"description": "…"}. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1274,7 +1278,7 @@ $ ycli datalens htmlpages delete [OPTIONS] ENTRY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1302,7 +1306,7 @@ $ ycli datalens htmlpages preview-url-get [OPTIONS] ENTRY_ID * `--lang TEXT`: Language of the preview. Known values: en, ru. * `--theme TEXT`: Theme of the preview. Known values: light, dark, light-hc, dark-hc, system. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1347,7 +1351,7 @@ $ ycli datalens members list [OPTIONS] * `--tab-id TEXT`: Keep one kind of subject. Known values: SUBJECT_TYPE_UNSPECIFIED, USER_ACCOUNT, GROUP, INVITEE, SERVICE_ACCOUNT, _system. * `--filter TEXT`: A filter expression of the API. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1405,7 +1409,7 @@ $ ycli datalens entries list [OPTIONS] * `--ignore-shared-entries / --no-ignore-shared-entries`: Leave out the shared entries. * `--include-data / --no-include-data`: Also give the content of each. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1435,7 +1439,7 @@ $ ycli datalens entries relations-list [OPTIONS] ENTRY_ID... * `--include-permissions-info / --no-include-permissions-info`: Also say what you may do with it. * `--scope TEXT`: Keep one kind of related entry. Known values: dash, report, widget, dataset, folder, connection, compute, artifact, sql_query. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1459,7 +1463,7 @@ $ ycli datalens entries permissions-get [OPTIONS] ENTRY_ID... **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1487,7 +1491,7 @@ $ ycli datalens entries revisions-list [OPTIONS] ENTRY_ID * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `--rev-id TEXT`: Keep this revision (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1512,7 +1516,7 @@ $ ycli datalens entries rename [OPTIONS] ENTRY_ID * `--name TEXT`: The new name. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1555,7 +1559,7 @@ $ ycli datalens permissions get-bulk [OPTIONS] * `--workbook-id TEXT`: A workbook id (repeatable). * `--collection-id TEXT`: A collection id (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1603,7 +1607,7 @@ $ ycli datalens connections get [OPTIONS] CONNECTION_ID * `--binded-dataset-id TEXT`: A dataset bound to it, to read it through. * `--rev-id TEXT`: The revision to read; the current by default. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1626,7 +1630,7 @@ $ ycli datalens connections create [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1653,7 +1657,7 @@ $ ycli datalens connections update [OPTIONS] CONNECTION_ID * `--data TEXT`: The fields to change, as a JSON object: {"host": "db2.example.net"}. --body-file and -F give them under `data` (-F 'data[port]=8443'). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1685,7 +1689,7 @@ $ ycli datalens connections delete [OPTIONS] CONNECTION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1734,7 +1738,7 @@ $ ycli datalens datasets get [OPTIONS] DATASET_ID * `--workbook-id TEXT`: The workbook the dataset lies in. * `--rev-id TEXT`: The revision to read; the current by default. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1765,7 +1769,7 @@ $ ycli datalens datasets create [OPTIONS] * `--saved-id TEXT`: The saved revision. * `--workbook-id TEXT`: The workbook to create it in. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1793,7 +1797,7 @@ $ ycli datalens datasets update [OPTIONS] DATASET_ID * `--data TEXT`: What to save, as a JSON object: {"dataset": {...}, "mode": "save"}. --body-file gives it under `data`. * `--workbook-id TEXT`: The workbook the dataset lies in. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1822,7 +1826,7 @@ $ ycli datalens datasets delete [OPTIONS] DATASET_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1849,7 +1853,7 @@ $ ycli datalens datasets validate [OPTIONS] DATASET_ID * `--binded-dataset-id TEXT`: A dataset bound to this one. * `--data TEXT`: What to check, as a JSON object: {"dataset": {...}, "updates": [...]}. --body-file gives it under `data`. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1880,7 +1884,7 @@ $ ycli datalens datasets data-get [OPTIONS] DATASET_ID * `--limit INTEGER`: The most rows to return; 100 by default. * `--offset INTEGER`: How many rows to skip; above zero it needs --sort. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1929,7 +1933,7 @@ $ ycli datalens charts data-get [OPTIONS] CHART_ID * `--params TEXT`: Values for the chart's parameters, as a JSON object: {"year": "2026", "city": ["Moscow", "Kazan"]}. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1980,7 +1984,7 @@ $ ycli datalens charts wizard get [OPTIONS] CHART_ID * `--include-favorite / --no-include-favorite`: Also say whether it is a favourite. * `--branch TEXT`: The version to read when no revision is named: saved or published. A save writes the saved one: read `saved` before you change a chart. Known values: saved, published. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2008,7 +2012,7 @@ $ ycli datalens charts wizard create [OPTIONS] * `--workbook-id TEXT`: The workbook to create it in. * `--name TEXT`: The chart's name. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2041,7 +2045,7 @@ $ ycli datalens charts wizard update [OPTIONS] CHART_ID * `--annotation TEXT`: A description, as a JSON object: {"description": "…"}. * `--rev-id TEXT`: The revision the change is made on; DataLens does not check it (measured). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2071,7 +2075,7 @@ $ ycli datalens charts wizard delete [OPTIONS] CHART_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2122,7 +2126,7 @@ $ ycli datalens charts ql get [OPTIONS] CHART_ID * `--include-favorite / --no-include-favorite`: Also say whether it is a favourite. * `--branch TEXT`: The version to read when no revision is named: saved or published. A save writes the saved one: read `saved` before you change a chart. Known values: saved, published. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2148,7 +2152,7 @@ $ ycli datalens charts ql create [OPTIONS] * `--workbook-id TEXT`: The workbook to create it in. * `--name TEXT`: The chart's name. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2179,7 +2183,7 @@ $ ycli datalens charts ql update [OPTIONS] ENTRY_ID * `--data TEXT`: What the chart holds, as a JSON object (its query and how it is shown); --body-file gives it under `data`. * `--annotation TEXT`: A description, as a JSON object: {"description": "…"}. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2203,7 +2207,7 @@ $ ycli datalens charts ql delete [OPTIONS] CHART_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2254,7 +2258,7 @@ $ ycli datalens charts editor get [OPTIONS] CHART_ID * `--include-favorite / --no-include-favorite`: Also say whether it is a favourite. * `--branch TEXT`: The version to read when no revision is named: saved or published. A save writes the saved one: read `saved` before you change a chart. Known values: saved, published. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2275,7 +2279,7 @@ $ ycli datalens charts editor create [OPTIONS] * `--entry TEXT`: The chart, as a JSON object; `type` says which kind it is. --body-file gives it under `entry`. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2300,7 +2304,7 @@ $ ycli datalens charts editor update [OPTIONS] * `--mode TEXT`: Keep the change as a draft, or publish it. Known values: save, publish. [required] * `--entry TEXT`: The chart, as a JSON object; `type` says which kind it is. --body-file gives it under `entry`. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2324,7 +2328,7 @@ $ ycli datalens charts editor delete [OPTIONS] CHART_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2377,7 +2381,7 @@ $ ycli datalens dashboards get [OPTIONS] DASHBOARD_ID * `--branch TEXT`: The version to read when no revision is named: saved or published. A save writes the saved one: read `saved` before you change a dashboard. Known values: saved, published. * `--workbook-id TEXT`: The workbook the dashboard lies in. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2401,7 +2405,7 @@ $ ycli datalens dashboards create [OPTIONS] * `--entry TEXT`: The dashboard, as a JSON object; --body-file gives it under `entry`. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2427,7 +2431,7 @@ $ ycli datalens dashboards update [OPTIONS] * `--entry TEXT`: The dashboard, as a JSON object; --body-file gives it under `entry`. * `--lock-token TEXT`: The token of the lock held on it, when it is locked. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2452,7 +2456,7 @@ $ ycli datalens dashboards delete [OPTIONS] DASHBOARD_ID * `--lock-token TEXT`: The token of the lock held on it, when it is locked. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2502,7 +2506,7 @@ $ ycli datalens reports get [OPTIONS] ENTRY_ID * `--include-permissions / --no-include-permissions`: Also say what you may do with the report. * `--include-favorite / --no-include-favorite`: Also say whether the report is a favourite. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2532,7 +2536,7 @@ $ ycli datalens reports create [OPTIONS] * `--workbook-id TEXT`: The workbook to create the report in. * `--name TEXT`: The report's name. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2568,7 +2572,7 @@ $ ycli datalens reports update [OPTIONS] ENTRY_ID * `--rev-id TEXT`: The revision of the report to change; DataLens does not check it (measured). * `--annotation TEXT`: A description of the report, as JSON: {"description": "…"}. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2592,7 +2596,7 @@ $ ycli datalens reports delete [OPTIONS] ENTRY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2640,7 +2644,7 @@ $ ycli datalens workbookexports start [OPTIONS] WORKBOOK_ID * `--wait / --no-wait`: Poll to a terminal status before printing. [default: wait] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2664,7 +2668,7 @@ $ ycli datalens workbookexports status-get [OPTIONS] EXPORT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2691,7 +2695,7 @@ $ ycli datalens workbookexports result-get [OPTIONS] EXPORT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2717,7 +2721,7 @@ $ ycli datalens workbookexports cancel [OPTIONS] EXPORT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2768,7 +2772,7 @@ $ ycli datalens workbookimports start [OPTIONS] * `--description TEXT`: The description of the new workbook. * `--wait / --no-wait`: Poll to a terminal status before printing. [default: wait] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2792,7 +2796,7 @@ $ ycli datalens workbookimports status-get [OPTIONS] IMPORT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2837,7 +2841,7 @@ $ ycli datalens embeds list [OPTIONS] ENTRY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2848,6 +2852,8 @@ $ ycli datalens embeds list [OPTIONS] ENTRY_ID Embed an entry; the title, the key, the entry, the mode and the settings are required. +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -2865,7 +2871,7 @@ $ ycli datalens embeds create [OPTIONS] * `--unsigned-params TEXT`: A parameter a link may carry unsigned (repeatable). * `--private-params TEXT`: A parameter that goes signed, in the token (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2876,6 +2882,8 @@ $ ycli datalens embeds create [OPTIONS] Save an embed as given: the API takes it whole, so name everything that is to stay. +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -2896,7 +2904,7 @@ $ ycli datalens embeds update [OPTIONS] EMBED_ID * `--unsigned-params TEXT`: A parameter a link may carry unsigned (repeatable). * `--private-params TEXT`: A parameter that goes signed, in the token (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2920,7 +2928,7 @@ $ ycli datalens embeds delete [OPTIONS] EMBED_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2965,7 +2973,7 @@ $ ycli datalens embeddingsecrets get [OPTIONS] EMBEDDING_SECRET_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2989,7 +2997,7 @@ $ ycli datalens embeddingsecrets list [OPTIONS] WORKBOOK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3003,6 +3011,8 @@ Make a key for embedding; prints its id and its private key. The private key is given once: `get` and `list` do not return it. Keep it at once, in a file nobody else reads: `ycli -o json datalens embeddingsecrets create … > secret.json`. +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -3014,7 +3024,7 @@ $ ycli datalens embeddingsecrets create [OPTIONS] * `--title TEXT`: The name of the key. [required] * `--workbook-id TEXT`: The workbook the key belongs to. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3038,7 +3048,7 @@ $ ycli datalens embeddingsecrets delete [OPTIONS] EMBEDDING_SECRET_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3085,7 +3095,7 @@ $ ycli datalens sharedentries access-bindings-list [OPTIONS] ENTRY_ID * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `--get-inherited-bindings / --no-get-inherited-bindings`: Also list the inherited roles. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3096,6 +3106,8 @@ $ ycli datalens sharedentries access-bindings-list [OPTIONS] ENTRY_ID Give or take away roles on a shared entry; the roles not named stay as they are. +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -3110,7 +3122,7 @@ $ ycli datalens sharedentries access-bindings-update [OPTIONS] ENTRY_ID * `--delta TEXT`: A role to add or remove, as a JSON object of the API docs: {"action": "ADD", "accessBinding": {"roleId": ..., "subject": {"id": ..., "type": ...}}} (repeatable). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3154,7 +3166,7 @@ $ ycli datalens audit entries-updates-list [OPTIONS] * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3179,7 +3191,7 @@ $ ycli datalens audit entry-permissions-get [OPTIONS] ENTRY_ID... * `--user-id TEXT`: The user's id, as `createdBy` of an entry gives it. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3228,7 +3240,7 @@ $ ycli datalens sqlqueries get [OPTIONS] SQL_QUERY_ID * `--include-permissions / --no-include-permissions`: Also say what you may do with the query. * `--include-favorite / --no-include-favorite`: Also say whether the query is a favourite. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3258,7 +3270,7 @@ $ ycli datalens sqlqueries create [OPTIONS] * `--description TEXT`: A description. * `--params TEXT`: The parameters the text takes, as a JSON array: [{"name": "since", "type": "date", "defaultValue": "2026-01-01"}]. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3288,7 +3300,7 @@ $ ycli datalens sqlqueries update [OPTIONS] SQL_QUERY_ID * `--description TEXT`: A description. * `--params TEXT`: The parameters the text takes, as a JSON array: [{"name": "since", "type": "date", "defaultValue": "2026-01-01"}]. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3314,7 +3326,7 @@ $ ycli datalens sqlqueries delete [OPTIONS] SQL_QUERY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3341,7 +3353,7 @@ $ ycli datalens sqlqueries run [OPTIONS] SQL_QUERY_ID * `--params TEXT`: The values of the parameters, as a JSON object: {"since": "2026-10-01"}. A parameter left out takes its default. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3391,7 +3403,7 @@ $ ycli datalens licensing licenses-list [OPTIONS] * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3402,6 +3414,8 @@ $ ycli datalens licensing licenses-list [OPTIONS] Give each of these users a licence. +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -3415,7 +3429,7 @@ $ ycli datalens licensing licenses-assign [OPTIONS] USER_ID... **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3437,7 +3451,7 @@ $ ycli datalens licensing limit-get [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3461,7 +3475,7 @@ $ ycli datalens licensing limit-set [OPTIONS] VALUE **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3510,7 +3524,7 @@ $ ycli datalens cloudenvironments list [OPTIONS] * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3535,7 +3549,7 @@ $ ycli datalens cloudenvironments get [OPTIONS] ID * `--include-permissions / --no-include-permissions`: Also say what you may do with the environment. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3561,7 +3575,7 @@ $ ycli datalens cloudenvironments create [OPTIONS] * `--security-group-ids TEXT`: A security group it uses (repeatable). * `--storage TEXT`: The settings of its storage bucket, as a JSON object: {"maxSize": "0"} (bytes; zero is unlimited). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3591,7 +3605,7 @@ $ ycli datalens cloudenvironments update [OPTIONS] ID * `--security-group-ids TEXT`: A security group it uses (repeatable). * `--storage TEXT`: The settings of its storage bucket, as a JSON object: {"maxSize": "0"} (bytes; zero is unlimited). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3617,7 +3631,7 @@ $ ycli datalens cloudenvironments delete [OPTIONS] ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3668,7 +3682,7 @@ $ ycli datalens cloudenvironmentstorage bucket-objects-list [OPTIONS] CLOUD_ENVI * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3695,7 +3709,7 @@ $ ycli datalens cloudenvironmentstorage bucket-object-metadata-get [OPTIONS] CLO * `--path TEXT`: The path of the object in the bucket. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3722,7 +3736,7 @@ $ ycli datalens cloudenvironmentstorage bucket-download-url-create [OPTIONS] CLO * `--path TEXT`: The path of the object in the bucket. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3751,7 +3765,7 @@ $ ycli datalens cloudenvironmentstorage bucket-upload-url-create [OPTIONS] CLOUD * `--size TEXT`: The size of the object in bytes. [required] * `--content-md5 TEXT`: The MD5 digest of the content, base64-encoded. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3800,7 +3814,7 @@ $ ycli datalens restcatalogs list [OPTIONS] * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3825,7 +3839,7 @@ $ ycli datalens restcatalogs create [OPTIONS] * `--description TEXT`: A description. * `--labels TEXT`: Labels, as a JSON object: {"team": "analytics"}. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3869,7 +3883,7 @@ $ ycli datalens lakehouseoperations get [OPTIONS] OPERATION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3924,7 +3938,7 @@ $ ycli datalens trinoclusters list [OPTIONS] * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3948,7 +3962,7 @@ $ ycli datalens trinoclusters get [OPTIONS] ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3978,7 +3992,7 @@ $ ycli datalens trinoclusters create [OPTIONS] * `--catalogs-config TEXT`: A REST catalog to attach, as a JSON object: {"catalogId": "…"} (repeatable). * `--trino-version TEXT`: The version of Trino; the service's own if not. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4004,7 +4018,7 @@ $ ycli datalens trinoclusters delete [OPTIONS] ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4030,7 +4044,7 @@ $ ycli datalens trinoclusters start [OPTIONS] CLUSTER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4056,7 +4070,7 @@ $ ycli datalens trinoclusters stop [OPTIONS] CLUSTER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4083,7 +4097,7 @@ $ ycli datalens trinoclusters catalog-create [OPTIONS] CLUSTER_ID * `--catalog TEXT`: The REST catalog to attach, as a JSON object: {"catalogId": "…"}. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4110,7 +4124,7 @@ $ ycli datalens trinoclusters catalog-delete [OPTIONS] CLUSTER_ID * `--catalog-id TEXT`: The id of the REST catalog to detach. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4139,7 +4153,7 @@ $ ycli datalens trinoclusters resource-presets-list [OPTIONS] CLOUD_ENVIRONMENT_ * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4166,7 +4180,7 @@ $ ycli datalens trinoclusters resource-preset-get [OPTIONS] RESOURCE_PRESET_ID * `--cloud-environment-id TEXT`: The cloud environment the presets are of. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4218,7 +4232,7 @@ $ ycli datalens sparkapplications list [OPTIONS] CLUSTER_ID * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4245,7 +4259,7 @@ $ ycli datalens sparkapplications get [OPTIONS] CLUSTER_ID * `--application-id TEXT`: Id of the Spark application. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4279,7 +4293,7 @@ $ ycli datalens sparkapplications create [OPTIONS] CLUSTER_ID * `--pyspark-application TEXT`: An application in a Python file, as a JSON object: {"mainPythonFileUri": "…", "args": ["…"]}. * `--spark-connect-application TEXT`: A Spark Connect application, as a JSON object: {"properties": {"…": "…"}}. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4306,7 +4320,7 @@ $ ycli datalens sparkapplications cancel [OPTIONS] CLUSTER_ID * `--application-id TEXT`: Id of the Spark application. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4335,7 +4349,7 @@ $ ycli datalens sparkapplications log-list [OPTIONS] CLUSTER_ID * `--page-size INTEGER`: The most characters the fragment may hold. * `--page-token TEXT`: The token of the fragment to read; the first if not. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. diff --git a/docs/en/reference/cli/forms.md b/docs/en/reference/cli/forms.md index 3f63d8b60..3e9933c9a 100644 --- a/docs/en/reference/cli/forms.md +++ b/docs/en/reference/cli/forms.md @@ -70,7 +70,7 @@ $ ycli forms auth status [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -108,7 +108,7 @@ $ ycli forms me get [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -162,7 +162,7 @@ $ ycli forms surveys list [OPTIONS] * `--show-all / --no-show-all`: As an administrator, every form of the organization. * `--orderby TEXT`: Sort, e.g. name,-modified,-count. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -186,7 +186,7 @@ $ ycli forms surveys get [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -212,7 +212,7 @@ $ ycli forms surveys create [OPTIONS] * `--need-auth / --no-need-auth`: Require sign-in to fill. * `--max-count INTEGER`: Maximum number of responses (0: no cap). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -242,7 +242,7 @@ $ ycli forms surveys update [OPTIONS] SURVEY_ID * `--need-auth / --no-need-auth`: Toggle sign-in requirement. * `--max-count INTEGER`: New response cap (0 removes the cap). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -266,7 +266,7 @@ $ ycli forms surveys delete [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -290,7 +290,7 @@ $ ycli forms surveys publish [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -314,7 +314,7 @@ $ ycli forms surveys unpublish [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -361,7 +361,7 @@ $ ycli forms questions list [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -387,7 +387,7 @@ $ ycli forms questions get [OPTIONS] SURVEY_ID QUESTION_ID * `--with-slugs / --no-with-slugs`: Refer to other questions by slug, not id. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -421,7 +421,7 @@ $ ycli forms questions create [OPTIONS] SURVEY_ID * `--widget TEXT`: How an enum question shows its options. Known values: radio, checkbox, dropdown, stars, onerow. * `--option TEXT`: Enum option label (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -456,7 +456,7 @@ $ ycli forms questions update [OPTIONS] SURVEY_ID QUESTION_ID * `--widget TEXT`: How an enum question shows its options. Known values: radio, checkbox, dropdown, stars, onerow. * `--option TEXT`: Enum option label (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -482,7 +482,7 @@ $ ycli forms questions delete [OPTIONS] SURVEY_ID QUESTION_ID * `--force / --no-force`: Ignored by the API: a question that a display condition refers to is refused all the same. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -515,7 +515,7 @@ $ ycli forms questions move [OPTIONS] SURVEY_ID QUESTION_ID * `--create-page / --no-create-page`: Create a new page for the question. * `--question TEXT`: Question id/slug to move into a question series. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -584,7 +584,7 @@ $ ycli forms conditions question list [OPTIONS] SURVEY_ID QUESTION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -610,7 +610,7 @@ $ ycli forms conditions question get [OPTIONS] SURVEY_ID QUESTION_ID CONDITION_I **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -637,7 +637,7 @@ $ ycli forms conditions question create [OPTIONS] SURVEY_ID QUESTION_ID * `--operator TEXT`: Boolean operator. Known values: and, or. * `--item TEXT`: Condition clause as JSON: {"type", "condition", "question"?, "value"?} (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -665,7 +665,7 @@ $ ycli forms conditions question update [OPTIONS] SURVEY_ID QUESTION_ID CONDITIO * `--operator TEXT`: Boolean operator. Known values: and, or. * `--item TEXT`: Condition clause as JSON: {"type", "condition", "question"?, "value"?} (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -691,7 +691,7 @@ $ ycli forms conditions question delete [OPTIONS] SURVEY_ID QUESTION_ID CONDITIO **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -717,7 +717,7 @@ $ ycli forms conditions question update-operator [OPTIONS] SURVEY_ID QUESTION_ID * `--operator TEXT`: Boolean operator. Known values: and, or. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -765,7 +765,7 @@ $ ycli forms conditions page list [OPTIONS] SURVEY_ID PAGE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -791,7 +791,7 @@ $ ycli forms conditions page get [OPTIONS] SURVEY_ID PAGE_ID CONDITION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -818,7 +818,7 @@ $ ycli forms conditions page create [OPTIONS] SURVEY_ID PAGE_ID * `--operator TEXT`: Boolean operator. Known values: and, or. * `--item TEXT`: Condition clause as JSON: {"type", "condition", "question"?, "value"?} (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -846,7 +846,7 @@ $ ycli forms conditions page update [OPTIONS] SURVEY_ID PAGE_ID CONDITION_ID * `--operator TEXT`: Boolean operator. Known values: and, or. * `--item TEXT`: Condition clause as JSON: {"type", "condition", "question"?, "value"?} (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -872,7 +872,7 @@ $ ycli forms conditions page delete [OPTIONS] SURVEY_ID PAGE_ID CONDITION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -898,7 +898,7 @@ $ ycli forms conditions page update-operator [OPTIONS] SURVEY_ID PAGE_ID * `--operator TEXT`: Boolean operator. Known values: and, or. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -945,7 +945,7 @@ $ ycli forms conditions submit list [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -970,7 +970,7 @@ $ ycli forms conditions submit get [OPTIONS] SURVEY_ID CONDITION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -996,7 +996,7 @@ $ ycli forms conditions submit create [OPTIONS] SURVEY_ID * `--operator TEXT`: Boolean operator. Known values: and, or. * `--item TEXT`: Condition clause as JSON: {"type", "condition", "question"?, "value"?} (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1023,7 +1023,7 @@ $ ycli forms conditions submit update [OPTIONS] SURVEY_ID CONDITION_ID * `--operator TEXT`: Boolean operator. Known values: and, or. * `--item TEXT`: Condition clause as JSON: {"type", "condition", "question"?, "value"?} (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1048,7 +1048,7 @@ $ ycli forms conditions submit delete [OPTIONS] SURVEY_ID CONDITION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1073,7 +1073,7 @@ $ ycli forms conditions submit update-operator [OPTIONS] SURVEY_ID * `--operator TEXT`: Boolean operator. Known values: and, or. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1121,7 +1121,7 @@ $ ycli forms conditions hook list [OPTIONS] SURVEY_ID HOOK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1147,7 +1147,7 @@ $ ycli forms conditions hook get [OPTIONS] SURVEY_ID HOOK_ID CONDITION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1174,7 +1174,7 @@ $ ycli forms conditions hook create [OPTIONS] SURVEY_ID HOOK_ID * `--operator TEXT`: Boolean operator. Known values: and, or. * `--item TEXT`: Condition clause as JSON: {"type", "condition", "question"?, "value"?} (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1202,7 +1202,7 @@ $ ycli forms conditions hook update [OPTIONS] SURVEY_ID HOOK_ID CONDITION_ID * `--operator TEXT`: Boolean operator. Known values: and, or. * `--item TEXT`: Condition clause as JSON: {"type", "condition", "question"?, "value"?} (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1228,7 +1228,7 @@ $ ycli forms conditions hook delete [OPTIONS] SURVEY_ID HOOK_ID CONDITION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1254,7 +1254,7 @@ $ ycli forms conditions hook update-operator [OPTIONS] SURVEY_ID HOOK_ID * `--operator TEXT`: Boolean operator. Known values: and, or. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1299,7 +1299,7 @@ $ ycli forms access list [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1310,6 +1310,8 @@ $ ycli forms access list [OPTIONS] SURVEY_ID Set the access level of one action on form SURVEY_ID (POST …/access). +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -1325,7 +1327,7 @@ $ ycli forms access update [OPTIONS] SURVEY_ID * `--action TEXT`: Action: change (edit, read answers) or submit (fill in). [required] * `--access TEXT`: Level of access. Known values: owner, restricted, common, public. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1336,6 +1338,8 @@ $ ycli forms access update [OPTIONS] SURVEY_ID Let a user (--uid / --cloud-uid) or a group (--group-src + --group-id) perform ACTION. +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -1354,7 +1358,7 @@ $ ycli forms access grant [OPTIONS] SURVEY_ID * `--group-src TEXT`: Where the group is kept. Known values: dir, cloud, com, staff. * `--group-id TEXT`: Group id within its source. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1383,7 +1387,7 @@ $ ycli forms access revoke [OPTIONS] SURVEY_ID * `--group-src TEXT`: Where the group is kept. Known values: dir, cloud, com, staff. * `--group-id TEXT`: Group id within its source. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1429,7 +1433,7 @@ $ ycli forms history list [OPTIONS] SURVEY_ID * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1477,7 +1481,7 @@ $ ycli forms answers get [OPTIONS] * `--answer-id INTEGER`: Numeric answer id (needs form-edit access). * `--answer-key TEXT`: Answer key hash (works without form-edit access). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1515,7 +1519,7 @@ $ ycli forms answers list [OPTIONS] SURVEY_ID * `--page-size INTEGER`: Answers per request (the API's default is 25). * `--answer-format TEXT`: default is cells by column, raw is as stored. Known values: default, raw. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1541,7 +1545,7 @@ $ ycli forms answers columns-list [OPTIONS] SURVEY_ID * `--questions TEXT`: Comma-separated question ids to return columns for. * `--use-slugs / --no-use-slugs`: Name questions by slug, not id. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1574,7 +1578,7 @@ $ ycli forms answers export [OPTIONS] SURVEY_ID * `--upload-files / --no-upload-files`: Also export uploaded files to Disk. * `--wait / --no-wait`: Poll to a terminal status, then download. [default: wait] * `--output TEXT`: Write the exported file here; omit / '-' streams to stdout. -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1596,7 +1600,7 @@ $ ycli forms answers integrations-list [OPTIONS] * `--answer-id INTEGER`: Numeric answer id (needs form-edit access). * `--answer-key TEXT`: Answer key hash (works without form-edit access). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1621,7 +1625,7 @@ $ ycli forms answers delete [OPTIONS] SURVEY_ID ANSWER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1646,7 +1650,7 @@ $ ycli forms answers restore [OPTIONS] SURVEY_ID ANSWER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1693,7 +1697,7 @@ $ ycli forms keysets list [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1718,7 +1722,7 @@ $ ycli forms keysets get [OPTIONS] SURVEY_ID KEYSET_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1747,7 +1751,7 @@ $ ycli forms keysets create [OPTIONS] SURVEY_ID * `--total INTEGER`: Number of keys to generate. [required] * `--enabled / --disabled`: Create the set active (required — the API rejects a create without it). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1777,7 +1781,7 @@ $ ycli forms keysets update [OPTIONS] SURVEY_ID KEYSET_ID * `--total INTEGER`: Number of keys (required — replaces the record); the API refuses a number smaller than the set has now. [required] * `--enabled / --disabled`: Active flag (required). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1802,7 +1806,7 @@ $ ycli forms keysets delete [OPTIONS] SURVEY_ID KEYSET_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1828,7 +1832,7 @@ $ ycli forms keysets download [OPTIONS] SURVEY_ID KEYSET_ID * `--output TEXT`: Write bytes to this path; omit / '-' streams to stdout. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1870,7 +1874,7 @@ $ ycli forms operations get [OPTIONS] OPERATION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1931,7 +1935,7 @@ $ ycli forms notifications list [OPTIONS] * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1955,7 +1959,7 @@ $ ycli forms notifications get [OPTIONS] NOTIFICATION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1979,7 +1983,7 @@ $ ycli forms notifications status-get [OPTIONS] NOTIFICATION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2003,7 +2007,7 @@ $ ycli forms notifications restart [OPTIONS] NOTIFICATION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2027,7 +2031,7 @@ $ ycli forms notifications cancel [OPTIONS] NOTIFICATION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2051,7 +2055,7 @@ $ ycli forms notifications errors-list [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2097,7 +2101,7 @@ $ ycli forms files upload [OPTIONS] SURVEY_ID FILE_PATH **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2123,7 +2127,7 @@ $ ycli forms files verify [OPTIONS] SURVEY_ID * `--path TEXT`: File path to check (repeatable). * `--url TEXT`: File URL to check (repeatable, paired to --path). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2147,7 +2151,7 @@ $ ycli forms files download [OPTIONS] * `--download / --no-download`: Ask the API for a Content-Disposition filename header. * `--hash TEXT`: Access hash from the upload response (anonymous download). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2169,7 +2173,7 @@ $ ycli forms files delete [OPTIONS] * `--path TEXT`: File download path (from an upload response). * `--url TEXT`: File download URL (from an upload response). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2213,7 +2217,7 @@ $ ycli forms images upload [OPTIONS] SURVEY_ID IMAGE_PATH **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2240,7 +2244,7 @@ $ ycli forms images clone [OPTIONS] SURVEY_ID * `--name TEXT`: Ignored by the API: the clone keeps the file name of the original. * `--link TEXT`: SIZE=URL of the image to clone (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2285,7 +2289,7 @@ $ ycli forms filling get [OPTIONS] SURVEY_ID * `--key TEXT`: Personal-link fill key, when the form uses one. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2314,7 +2318,7 @@ $ ycli forms filling submit [OPTIONS] SURVEY_ID * `--validate-only / --no-validate-only`: Validate only — save nothing, fire no integrations. * `--key TEXT`: Personal-link fill key, when the form uses one. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2342,7 +2346,7 @@ $ ycli forms filling suggest [OPTIONS] SURVEY_ID * `--suggest-id TEXT`: Comma-separated suggestion-object ids to resolve. * `--parent-id TEXT`: Parent ids for a Master/Detail lookup. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2388,7 +2392,7 @@ $ ycli forms hooks list [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2413,7 +2417,7 @@ $ ycli forms hooks get [OPTIONS] SURVEY_ID HOOK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2439,7 +2443,7 @@ $ ycli forms hooks create [OPTIONS] SURVEY_ID * `--name TEXT`: Integration group name (max 100 characters). * `--active / --inactive`: Run the group's integrations, or pause them. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2466,7 +2470,7 @@ $ ycli forms hooks update [OPTIONS] SURVEY_ID HOOK_ID * `--name TEXT`: Integration group name (max 100 characters). * `--active / --inactive`: Run the group's integrations, or pause them. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2491,7 +2495,7 @@ $ ycli forms hooks delete [OPTIONS] SURVEY_ID HOOK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2539,7 +2543,7 @@ $ ycli forms subscriptions list [OPTIONS] SURVEY_ID HOOK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2565,7 +2569,7 @@ $ ycli forms subscriptions get [OPTIONS] SURVEY_ID HOOK_ID SUBSCRIPTION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2590,7 +2594,7 @@ $ ycli forms subscriptions create [OPTIONS] SURVEY_ID HOOK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2616,7 +2620,7 @@ $ ycli forms subscriptions update [OPTIONS] SURVEY_ID HOOK_ID SUBSCRIPTION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2642,7 +2646,7 @@ $ ycli forms subscriptions delete [OPTIONS] SURVEY_ID HOOK_ID SUBSCRIPTION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2669,7 +2673,7 @@ $ ycli forms subscriptions attach [OPTIONS] SURVEY_ID HOOK_ID SUBSCRIPTION_ID FI **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2711,7 +2715,7 @@ $ ycli forms variables list [OPTIONS] SURVEY_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. diff --git a/docs/en/reference/cli/index.md b/docs/en/reference/cli/index.md index 14d8baa43..e7218bb42 100644 --- a/docs/en/reference/cli/index.md +++ b/docs/en/reference/cli/index.md @@ -26,7 +26,7 @@ $ ycli [OPTIONS] COMMAND [ARGS]... **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). [default: auto] -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. diff --git a/docs/en/reference/cli/mcp.md b/docs/en/reference/cli/mcp.md index ceeff3aac..6597baf8d 100644 --- a/docs/en/reference/cli/mcp.md +++ b/docs/en/reference/cli/mcp.md @@ -45,7 +45,7 @@ $ ycli mcp start [OPTIONS] * `--host TEXT`: HTTP only: listen address (YCLI__MCP__HOST). * `--port INTEGER`: HTTP only: listen port (YCLI__MCP__PORT). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -74,7 +74,7 @@ $ ycli mcp methods [OPTIONS] * `--tool-search`: List a search tool and a call proxy instead of the tools (BM25); status_get and schema_get stay. * `--kind [tools|prompts|resources]`: What to list: tools (default), prompts, or resources (addresses and templates). [default: tools] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. diff --git a/docs/en/reference/cli/sync.md b/docs/en/reference/cli/sync.md index 72496105b..8ac83c653 100644 --- a/docs/en/reference/cli/sync.md +++ b/docs/en/reference/cli/sync.md @@ -41,7 +41,7 @@ $ ycli sync kinds [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -72,7 +72,7 @@ $ ycli sync status [OPTIONS] [PATHS]... * `--show-unchanged`: Also list the files that were not edited. * `--exit-code`: Exit with 7 when there is something to push. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -100,7 +100,7 @@ $ ycli sync validate [OPTIONS] [PATHS]... * `--kind TEXT`: Keep the files of this kind, e.g. wiki/page (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -130,7 +130,7 @@ $ ycli sync pull [OPTIONS] PATH * `--kind TEXT`: Keep the files of this kind, e.g. wiki/page (repeatable). * `--show-unchanged`: Also list the files that were the same. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -163,7 +163,7 @@ $ ycli sync diff [OPTIONS] [PATHS]... * `--show-secrets`: Show secrets as they are, not masked. * `--exit-code`: Exit with 7 when there is something to push, 8 when a file and its object went apart. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -197,7 +197,7 @@ $ ycli sync push [OPTIONS] [PATHS]... * `--prune COMMIT`: Also delete the objects whose files were deleted since this commit. * `--on-error [fail|abort]`: After a file fails: go on to the next, or end the run. [default: fail] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. diff --git a/docs/en/reference/cli/tracker.md b/docs/en/reference/cli/tracker.md index 04364a960..c4ba6cd56 100644 --- a/docs/en/reference/cli/tracker.md +++ b/docs/en/reference/cli/tracker.md @@ -88,7 +88,7 @@ $ ycli tracker auth status [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -126,7 +126,7 @@ $ ycli tracker me get [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -182,7 +182,7 @@ $ ycli tracker issues get [OPTIONS] ISSUE_KEY * `--expand TEXT`: Extra blocks to include in the reply. * `--fields TEXT`: Comma-separated fields to include in the reply. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -210,7 +210,7 @@ $ ycli tracker issues list [OPTIONS] * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -243,7 +243,7 @@ $ ycli tracker issues search [OPTIONS] QUERY * `--per-scroll INTEGER`: Issues per scroll page (1000 at most). * `--scroll-ttl-millis INTEGER`: How long the scroll stays open, in milliseconds. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -269,7 +269,7 @@ $ ycli tracker issues count [OPTIONS] * `--queue TEXT`: Queue key. * `--status TEXT`: Status key. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -297,7 +297,7 @@ $ ycli tracker issues create [OPTIONS] * `--tag TEXT`: Tag (repeatable). * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -327,7 +327,7 @@ $ ycli tracker issues update [OPTIONS] ISSUE_KEY * `--description TEXT`: New markdown body — pass "$(cat file.md)"; "" clears it. * `--tag TEXT`: Tag (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -357,7 +357,7 @@ $ ycli tracker issues move [OPTIONS] ISSUE_KEY QUEUE * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -386,7 +386,7 @@ $ ycli tracker issues suggest [OPTIONS] INPUT * `--expand TEXT`: Extra blocks to include in the reply. * `--embed TEXT`: Blocks of --expand to return in more detail. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -410,7 +410,7 @@ $ ycli tracker issues scroll-clear [OPTIONS] * `--next TOKEN`: The token a search by a scroll printed: it names the scroll to release. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -435,7 +435,7 @@ $ ycli tracker issues update-bulk [OPTIONS] * `--notify / --no-notify`: Notify affected users. * `--wait / --no-wait`: Poll to a terminal status before printing. [default: wait] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `--body-file FILE`: A JSON object (YAML in a .yaml / .yml file) laid under the request body: -F and the command's flags win over it. Objects merge; a list is replaced, not added to. YAML guesses types (no, 1.10): quote a value meant as text. @@ -465,7 +465,7 @@ $ ycli tracker issues move-bulk [OPTIONS] QUEUE * `--notify / --no-notify`: Notify affected users. * `--wait / --no-wait`: Poll to a terminal status before printing. [default: wait] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `--body-file FILE`: A JSON object (YAML in a .yaml / .yml file) laid under the request body: -F and the command's flags win over it. Objects merge; a list is replaced, not added to. YAML guesses types (no, 1.10): quote a value meant as text. @@ -493,7 +493,7 @@ $ ycli tracker issues transition-bulk [OPTIONS] TRANSITION * `--notify / --no-notify`: Notify affected users. * `--wait / --no-wait`: Poll to a terminal status before printing. [default: wait] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `--body-file FILE`: A JSON object (YAML in a .yaml / .yml file) laid under the request body: -F and the command's flags win over it. Objects merge; a list is replaced, not added to. YAML guesses types (no, 1.10): quote a value meant as text. @@ -519,7 +519,7 @@ $ ycli tracker issues import [OPTIONS] * `--description TEXT`: Issue description (YFM). * `--assignee TEXT`: Assignee login or id. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -571,7 +571,7 @@ $ ycli tracker comments list [OPTIONS] ISSUE_KEY * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `--expand TEXT`: Extra blocks to include in the reply. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -597,7 +597,7 @@ $ ycli tracker comments get [OPTIONS] ISSUE_KEY COMMENT_ID * `--expand TEXT`: Extra fields: attachments, html or all (comma-separated). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -622,7 +622,7 @@ $ ycli tracker comments create [OPTIONS] ISSUE_KEY * `--text TEXT`: Comment text — pass "$(cat note.md)" for markdown. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -648,7 +648,7 @@ $ ycli tracker comments update [OPTIONS] ISSUE_KEY COMMENT_ID * `--text TEXT`: New comment text (YFM markdown supported). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -673,7 +673,7 @@ $ ycli tracker comments delete [OPTIONS] ISSUE_KEY COMMENT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -699,7 +699,7 @@ $ ycli tracker comments reactions-create [OPTIONS] ISSUE_KEY COMMENT_ID NAME **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -726,7 +726,7 @@ $ ycli tracker comments import [OPTIONS] ISSUE_KEY * `--created-at TEXT`: Original creation time, YYYY-MM-DDThh:mm:ss.sss±hhmm. [required] * `--created-by TEXT`: Login or id of the original author. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -772,7 +772,7 @@ $ ycli tracker links list [OPTIONS] ISSUE_KEY **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -801,7 +801,7 @@ $ ycli tracker links list-filtered [OPTIONS] ISSUE_KEY * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -827,7 +827,7 @@ $ ycli tracker links create [OPTIONS] ISSUE_KEY RELATIONSHIP TARGET **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -852,7 +852,7 @@ $ ycli tracker links delete [OPTIONS] ISSUE_KEY LINK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -880,7 +880,7 @@ $ ycli tracker links import [OPTIONS] ISSUE_KEY * `--created-at TEXT`: Original creation time, YYYY-MM-DDThh:mm:ss.sss±hhmm. [required] * `--created-by TEXT`: Login or id of the original author. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -923,7 +923,7 @@ $ ycli tracker transitions list [OPTIONS] ISSUE_KEY **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -948,7 +948,7 @@ $ ycli tracker transitions execute [OPTIONS] ISSUE_KEY ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -999,7 +999,7 @@ $ ycli tracker worklog list [OPTIONS] ISSUE_KEY * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1022,7 +1022,7 @@ $ ycli tracker worklog search [OPTIONS] * `--created-from TEXT`: Range start, YYYY-MM-DDThh:mm:ss. * `--created-to TEXT`: Range end, YYYY-MM-DDThh:mm:ss. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1045,7 +1045,7 @@ $ ycli tracker worklog list-global [OPTIONS] * `--created-from TEXT`: Range start, YYYY-MM-DDThh:mm:ss. * `--created-to TEXT`: Range end, YYYY-MM-DDThh:mm:ss. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1072,7 +1072,7 @@ $ ycli tracker worklog create [OPTIONS] ISSUE_KEY * `--start TEXT`: Work start time, YYYY-MM-DDThh:mm:ss.sss±hhmm. [required] * `--comment TEXT`: Optional note saved in the time report. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1099,7 +1099,7 @@ $ ycli tracker worklog update [OPTIONS] ISSUE_KEY RECORD_ID * `--duration TEXT`: New time spent, ISO-8601 duration. * `--comment TEXT`: New note for the time report. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1124,7 +1124,7 @@ $ ycli tracker worklog delete [OPTIONS] ISSUE_KEY RECORD_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1153,7 +1153,7 @@ $ ycli tracker worklog import [OPTIONS] ISSUE_KEY * `--start TEXT`: Work start time, YYYY-MM-DDThh:mm:ss.sss±hhmm. [required] * `--comment TEXT`: Optional note saved in the time report. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1201,7 +1201,7 @@ $ ycli tracker changelog list [OPTIONS] ISSUE_KEY * `--change-type TEXT`: Only changes of this type, e.g. IssueWorkflow. * `--sort TEXT`: Order of the changes. Known values: asc, desc. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `--body-file FILE`: A JSON object (YAML in a .yaml / .yml file) laid under the request body: -F and the command's flags win over it. Objects merge; a list is replaced, not added to. YAML guesses types (no, 1.10): quote a value meant as text. @@ -1246,7 +1246,7 @@ $ ycli tracker checklists list [OPTIONS] ISSUE_KEY **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1275,7 +1275,7 @@ $ ycli tracker checklists create [OPTIONS] ISSUE_KEY * `--deadline TEXT`: Deadline date, YYYY-MM-DDThh:mm:ss.sss±hhmm. * `--deadline-type TEXT`: Deadline kind: date or quarter; the API requires it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1305,7 +1305,7 @@ $ ycli tracker checklists update [OPTIONS] ISSUE_KEY ITEM_ID * `--deadline TEXT`: Deadline date, YYYY-MM-DDThh:mm:ss.sss±hhmm. * `--deadline-type TEXT`: Deadline kind: date or quarter; the API requires it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1330,7 +1330,7 @@ $ ycli tracker checklists delete [OPTIONS] ISSUE_KEY ITEM_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1354,7 +1354,7 @@ $ ycli tracker checklists clear [OPTIONS] ISSUE_KEY **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1400,7 +1400,7 @@ $ ycli tracker columns list [OPTIONS] BOARD_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1425,7 +1425,7 @@ $ ycli tracker columns get [OPTIONS] BOARD_ID COLUMN_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1451,7 +1451,7 @@ $ ycli tracker columns create [OPTIONS] BOARD_ID * `--name TEXT`: Name of the new column. [required] * `--status TEXT`: Status key for the column (repeatable). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1478,7 +1478,7 @@ $ ycli tracker columns update [OPTIONS] BOARD_ID COLUMN_ID * `--name TEXT`: New column name. * `--status TEXT`: Replacement status key (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1503,7 +1503,7 @@ $ ycli tracker columns delete [OPTIONS] BOARD_ID COLUMN_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1544,7 +1544,7 @@ $ ycli tracker priorities list [OPTIONS] * `--localized / --no-localized`: --no-localized returns the names in every language. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1569,7 +1569,7 @@ $ ycli tracker priorities create [OPTIONS] * `--name-en TEXT`: Priority name in English. * `--description TEXT`: Description of the priority. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1597,7 +1597,7 @@ $ ycli tracker priorities update [OPTIONS] PRIORITY_ID * `--description TEXT`: New description of the priority. * `--version INTEGER`: Current version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1637,7 +1637,7 @@ $ ycli tracker issuetypes list [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1660,7 +1660,7 @@ $ ycli tracker issuetypes create [OPTIONS] * `--name-ru TEXT`: Issue type name in Russian. * `--name-en TEXT`: Issue type name in English. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1687,7 +1687,7 @@ $ ycli tracker issuetypes update [OPTIONS] ISSUE_TYPE_ID * `--name-en TEXT`: New issue type name in English. * `--version INTEGER`: Current version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1725,7 +1725,7 @@ $ ycli tracker linktypes list [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1769,7 +1769,7 @@ $ ycli tracker users get [OPTIONS] LOGIN_OR_ID * `--expand TEXT`: Extra data to include, e.g. groups. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1793,7 +1793,7 @@ $ ycli tracker users list [OPTIONS] * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `--expand TEXT`: Extra data to include, e.g. groups. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1833,7 +1833,7 @@ $ ycli tracker statuses list [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1857,7 +1857,7 @@ $ ycli tracker statuses create [OPTIONS] * `--name-ru TEXT`: Status name in Russian. * `--name-en TEXT`: Status name in English. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1887,7 +1887,7 @@ $ ycli tracker statuses update [OPTIONS] STATUS_ID * `--order INTEGER`: New display-order weight. * `--version INTEGER`: Current version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1927,7 +1927,7 @@ $ ycli tracker resolutions list [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1950,7 +1950,7 @@ $ ycli tracker resolutions create [OPTIONS] * `--name-ru TEXT`: Resolution name in Russian. * `--name-en TEXT`: Resolution name in English. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1979,7 +1979,7 @@ $ ycli tracker resolutions update [OPTIONS] RESOLUTION_ID * `--order INTEGER`: New display-order weight. * `--version INTEGER`: Current version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2036,7 +2036,7 @@ $ ycli tracker queues list [OPTIONS] * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `--expand TEXT`: Extra blocks to include in the reply. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2061,7 +2061,7 @@ $ ycli tracker queues get [OPTIONS] QUEUE_ID * `--expand TEXT`: Extra blocks to include, e.g. all or types,team,versions. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2085,7 +2085,7 @@ $ ycli tracker queues tags-list [OPTIONS] QUEUE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2109,7 +2109,7 @@ $ ycli tracker queues versions-list [OPTIONS] QUEUE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2133,7 +2133,7 @@ $ ycli tracker queues fields-list [OPTIONS] QUEUE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2159,7 +2159,7 @@ $ ycli tracker queues create [OPTIONS] * `--default-priority TEXT`: Key/id of the default priority. [required] * `--issue-type-config TEXT`: issueTypesConfig row as JSON, e.g. '{"issueType":"task","workflow":"oicn"}' (repeatable; a queue needs at least one). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2183,7 +2183,7 @@ $ ycli tracker queues delete [OPTIONS] QUEUE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2207,7 +2207,7 @@ $ ycli tracker queues restore [OPTIONS] QUEUE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2225,6 +2225,9 @@ A removal is not always the inverse of an addition: taking a user out of --read out of --write too (seen once, 2026-10-06). The command prints the permissions as they are after the change. +Grants access: asks before it is sent (--yes to skip). It asks even when the body only +takes rights away: the mark is of the operation. + **Usage**: ```console @@ -2242,7 +2245,7 @@ $ ycli tracker queues permissions-update [OPTIONS] QUEUE_ID * `--read TEXT`: Read-issue permission scope as a JSON object. * `--grant TEXT`: Change-settings permission scope as a JSON object. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2267,7 +2270,7 @@ $ ycli tracker queues tags-delete [OPTIONS] QUEUE_ID TAG **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2292,7 +2295,7 @@ $ ycli tracker queues versions-create [OPTIONS] * `--start-date TEXT`: Version start date (YYYY-MM-DD). * `--due-date TEXT`: Version due date (YYYY-MM-DD). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2317,7 +2320,7 @@ $ ycli tracker queues versions-get [OPTIONS] VERSION_ID * `--fields TEXT`: Comma-separated fields to return, e.g. name,dueDate,released. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2346,7 +2349,7 @@ $ ycli tracker queues versions-update [OPTIONS] VERSION_ID * `--due-date TEXT`: New version due date (YYYY-MM-DD). * `--fields TEXT`: Comma-separated fields to return, e.g. name,dueDate,released. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2370,7 +2373,7 @@ $ ycli tracker queues versions-delete [OPTIONS] VERSION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2395,7 +2398,7 @@ $ ycli tracker queues user-permissions-get [OPTIONS] QUEUE_ID USER **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2420,7 +2423,7 @@ $ ycli tracker queues group-permissions-get [OPTIONS] QUEUE_ID GROUP_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2465,7 +2468,7 @@ $ ycli tracker localfields list [OPTIONS] QUEUE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2490,7 +2493,7 @@ $ ycli tracker localfields get [OPTIONS] QUEUE_ID FIELD_KEY **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2524,7 +2527,7 @@ $ ycli tracker localfields create [OPTIONS] QUEUE_ID * `--option TEXT`: Allowed drop-down value (repeatable). * `--options-type TEXT`: Drop-down provider type for --option values. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2559,7 +2562,7 @@ $ ycli tracker localfields update [OPTIONS] QUEUE_ID FIELD_KEY * `--option TEXT`: Allowed drop-down value (repeatable). * `--options-type TEXT`: Drop-down provider type for --option values. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2602,7 +2605,7 @@ $ ycli tracker fields list [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2626,7 +2629,7 @@ $ ycli tracker fields get [OPTIONS] FIELD_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2658,7 +2661,7 @@ $ ycli tracker fields create [OPTIONS] * `--option TEXT`: Allowed drop-down value (repeatable). * `--options-type TEXT`: Drop-down provider type for --option values. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2687,7 +2690,7 @@ $ ycli tracker fields update [OPTIONS] FIELD_ID * `--options-type TEXT`: Drop-down provider type for --option values. * `--version INTEGER`: Current version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2711,7 +2714,7 @@ $ ycli tracker fields categories-create [OPTIONS] * `--name-en TEXT`: Category name in English. * `--description TEXT`: Description of the category. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2740,7 +2743,7 @@ $ ycli tracker fields categories-update [OPTIONS] CATEGORY_ID * `--description TEXT`: New description of the category. * `--version INTEGER`: Current version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2785,7 +2788,7 @@ $ ycli tracker components list [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2810,7 +2813,7 @@ $ ycli tracker components create [OPTIONS] * `--lead TEXT`: Login of the component's owner (lead). * `--assign-auto / --no-assign-auto`: Auto-assign the owner to issues. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2839,7 +2842,7 @@ $ ycli tracker components update [OPTIONS] COMPONENT_ID * `--assign-auto / --no-assign-auto`: Auto-assign the owner to issues. * `--version INTEGER`: Current version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2864,7 +2867,7 @@ $ ycli tracker components list-for-queue [OPTIONS] QUEUE_ID * `--fields TEXT`: Comma-separated fields to return, e.g. name,description,lead. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2889,7 +2892,7 @@ $ ycli tracker components get [OPTIONS] COMPONENT_ID * `--fields TEXT`: Comma-separated fields to return, e.g. name,description,lead. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2913,7 +2916,7 @@ $ ycli tracker components delete [OPTIONS] COMPONENT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2938,7 +2941,7 @@ $ ycli tracker components user-permissions-get [OPTIONS] COMPONENT_ID USER **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -2963,7 +2966,7 @@ $ ycli tracker components group-permissions-get [OPTIONS] COMPONENT_ID GROUP_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3008,7 +3011,7 @@ $ ycli tracker filters get [OPTIONS] FILTER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3031,7 +3034,7 @@ $ ycli tracker filters create [OPTIONS] * `--query TEXT`: Filtering conditions in Tracker query language. * `--filter TEXT`: Filtering conditions as a JSON object. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3058,7 +3061,7 @@ $ ycli tracker filters update [OPTIONS] FILTER_ID * `--query TEXT`: New filtering conditions in query language. * `--filter TEXT`: Replacement filtering conditions as a JSON object. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3082,7 +3085,7 @@ $ ycli tracker filters delete [OPTIONS] FILTER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3120,7 +3123,7 @@ $ ycli tracker applications list [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3165,7 +3168,7 @@ $ ycli tracker boards list [OPTIONS] * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3189,7 +3192,7 @@ $ ycli tracker boards get [OPTIONS] BOARD_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3214,7 +3217,7 @@ $ ycli tracker boards create [OPTIONS] * `--backlog / --no-backlog`: Enable the board backlog; the API takes it together with --sprints only. * `--sprints / --no-sprints`: Enable board sprints; the API takes them together with --backlog only. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3241,7 +3244,7 @@ $ ycli tracker boards update [OPTIONS] BOARD_ID * `--backlog / --no-backlog`: Enable the board backlog; the API takes it together with --sprints only. * `--sprints / --no-sprints`: Enable board sprints; the API takes them together with --backlog only. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3265,7 +3268,7 @@ $ ycli tracker boards delete [OPTIONS] BOARD_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3313,7 +3316,7 @@ $ ycli tracker sprints list [OPTIONS] BOARD_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3337,7 +3340,7 @@ $ ycli tracker sprints get [OPTIONS] SPRINT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3361,7 +3364,7 @@ $ ycli tracker sprints create [OPTIONS] * `--start-date TEXT`: Planned start date (YYYY-MM-DD). [required] * `--end-date TEXT`: Planned end date (YYYY-MM-DD). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3390,7 +3393,7 @@ $ ycli tracker sprints update [OPTIONS] SPRINT_ID * `--status TEXT`: New status. Known values: draft, in_progress, released, archived. * `--version INTEGER`: Current sprint version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3414,7 +3417,7 @@ $ ycli tracker sprints delete [OPTIONS] SPRINT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3439,7 +3442,7 @@ $ ycli tracker sprints start [OPTIONS] SPRINT_ID * `--version INTEGER`: Current sprint version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3464,7 +3467,7 @@ $ ycli tracker sprints archive [OPTIONS] SPRINT_ID * `--version INTEGER`: Current sprint version for the optimistic lock (?version=). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3514,7 +3517,7 @@ $ ycli tracker attachments list [OPTIONS] ISSUE **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3541,7 +3544,7 @@ $ ycli tracker attachments download [OPTIONS] ISSUE FILE_ID FILENAME * `-O, --output TEXT`: Write to this path; omit or '-' for stdout. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3567,7 +3570,7 @@ $ ycli tracker attachments thumbnails-download [OPTIONS] ISSUE FILE_ID * `-O, --output TEXT`: Write to this path; omit or '-' for stdout. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3592,7 +3595,7 @@ $ ycli tracker attachments get [OPTIONS] ISSUE FILE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3617,7 +3620,7 @@ $ ycli tracker attachments delete [OPTIONS] ISSUE FILE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3643,7 +3646,7 @@ $ ycli tracker attachments upload [OPTIONS] ISSUE FILE_PATH * `--rename-to TEXT`: Store the file under this name instead of its own. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3668,7 +3671,7 @@ $ ycli tracker attachments upload-temp [OPTIONS] FILE_PATH * `--rename-to TEXT`: Store the file under this name instead of its own. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3696,7 +3699,7 @@ $ ycli tracker attachments import [OPTIONS] ISSUE_KEY PATH * `--created-by TEXT`: Login or id of the original author. [required] * `--filename TEXT`: Override the attachment name (default: basename). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3725,7 +3728,7 @@ $ ycli tracker attachments import-for-comment [OPTIONS] ISSUE_KEY COMMENT_ID PAT * `--created-by TEXT`: Login or id of the original author. [required] * `--filename TEXT`: Override the attachment name (default: basename). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3771,7 +3774,7 @@ $ ycli tracker macros list [OPTIONS] QUEUE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3796,7 +3799,7 @@ $ ycli tracker macros get [OPTIONS] QUEUE_ID MACRO_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3823,7 +3826,7 @@ $ ycli tracker macros create [OPTIONS] QUEUE_ID * `--body TEXT`: Comment text created when the macro runs. * `--issue-update TEXT`: Field→value issue changes as a JSON object. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3851,7 +3854,7 @@ $ ycli tracker macros update [OPTIONS] QUEUE_ID MACRO_ID * `--body TEXT`: New comment text created when the macro runs. * `--issue-update TEXT`: Replacement field→value issue changes as a JSON object. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3876,7 +3879,7 @@ $ ycli tracker macros delete [OPTIONS] QUEUE_ID MACRO_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3925,7 +3928,7 @@ $ ycli tracker triggers list [OPTIONS] QUEUE_ID * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3950,7 +3953,7 @@ $ ycli tracker triggers get [OPTIONS] QUEUE_ID TRIGGER_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -3981,7 +3984,7 @@ $ ycli tracker triggers create [OPTIONS] QUEUE_ID * `--condition TEXT`: Trigger condition as a JSON object (repeatable). * `--active / --inactive`: Start active or disabled. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4011,7 +4014,7 @@ $ ycli tracker triggers update [OPTIONS] QUEUE_ID TRIGGER_ID * `--active / --inactive`: Activate or disable the trigger. * `--version INTEGER`: Current trigger version (optimistic lock). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4040,7 +4043,7 @@ $ ycli tracker triggers webhook-log-list [OPTIONS] QUEUE_ID TRIGGER_ID * `--date-from TEXT`: Range start (YYYY-MM-DDThh:mm:ss.sss±hhmm). * `--date-to TEXT`: Range end (YYYY-MM-DDThh:mm:ss.sss±hhmm). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4086,7 +4089,7 @@ $ ycli tracker autoactions get [OPTIONS] QUEUE_ID ACTION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4121,7 +4124,7 @@ $ ycli tracker autoactions create [OPTIONS] QUEUE_ID * `--interval-millis INTEGER`: Run interval in ms (default 3600000). * `--calendar-id INTEGER`: Working-calendar id for the active window. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4146,7 +4149,7 @@ $ ycli tracker autoactions logs-list [OPTIONS] QUEUE_ID ACTION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4172,7 +4175,7 @@ $ ycli tracker autoactions logs-get [OPTIONS] QUEUE_ID ACTION_ID RUN_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4215,7 +4218,7 @@ $ ycli tracker bulk get [OPTIONS] BULK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4242,7 +4245,7 @@ $ ycli tracker bulk issues-list [OPTIONS] BULK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4286,7 +4289,7 @@ $ ycli tracker remotelinks list [OPTIONS] ISSUE_KEY **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4314,7 +4317,7 @@ $ ycli tracker remotelinks create [OPTIONS] ISSUE_KEY * `--relationship TEXT`: Link type; RELATES is recommended, an unknown one is refused. [required] * `--backlink / --no-backlink`: Also create the mirror link in the app. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4339,7 +4342,7 @@ $ ycli tracker remotelinks delete [OPTIONS] ISSUE_KEY LINK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4381,7 +4384,7 @@ $ ycli tracker dashboards create [OPTIONS] * `--layout TEXT`: Layout mode, e.g. two-columns. * `--owner TEXT`: Owner login or id (defaults to creator). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4410,7 +4413,7 @@ $ ycli tracker dashboards widgets-create-cycle-time [OPTIONS] DASHBOARD_ID * `--to-status TEXT`: Status key work ends at (repeatable). * `--mode TEXT`: Display mode, e.g. common-lines. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4471,7 +4474,7 @@ $ ycli tracker entities get [OPTIONS] ENTITY_TYPE ID * `--expand TEXT`: Extra info, e.g. attachments. * `--fields TEXT`: Comma-separated extra fields to include. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4506,7 +4509,7 @@ $ ycli tracker entities create [OPTIONS] ENTITY_TYPE * `--tag TEXT`: Tag (repeatable). * `--fields TEXT`: Comma-separated fields to include in the reply. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4544,7 +4547,7 @@ $ ycli tracker entities update [OPTIONS] ENTITY_TYPE ID * `--expand TEXT`: Extra blocks to include in the reply. * `--fields TEXT`: Comma-separated fields to include in the reply. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4570,7 +4573,7 @@ $ ycli tracker entities delete [OPTIONS] ENTITY_TYPE ID * `--with-board / --no-with-board`: Also delete the entity's board. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4603,7 +4606,7 @@ $ ycli tracker entities search [OPTIONS] ENTITY_TYPE * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4634,7 +4637,7 @@ $ ycli tracker entities events-list [OPTIONS] ENTITY_TYPE ID * `--new-events-on-top / --no-new-events-on-top`: Newest events first. * `--direction TEXT`: forward (the default) or backward. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4659,7 +4662,7 @@ $ ycli tracker entities permissions-get [OPTIONS] ENTITY_TYPE ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4674,6 +4677,9 @@ The API accepts only ``grant`` / ``revoke`` actions, each mapping an access leve (READ/WRITE/GRANT) to users/groups/roles, e.g. ``--acl 'grant={"READ":{"users":["8000000000000002"]}}'``. +Grants access: asks before it is sent (--yes to skip). It asks even when the body only +takes rights away: the mark is of the operation. + **Usage**: ```console @@ -4689,7 +4695,7 @@ $ ycli tracker entities permissions-update [OPTIONS] ENTITY_TYPE ID * `--acl TEXT`: ACL change ACTION= where ACTION is grant or revoke, e.g. grant={"READ":{"users":["8000000000000002"]}} (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4714,7 +4720,7 @@ $ ycli tracker entities permissions-get-direct [OPTIONS] ENTITY_TYPE ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4725,6 +4731,9 @@ $ ycli tracker entities permissions-get-direct [OPTIONS] ENTITY_TYPE ID Grant and revoke an entity's direct rights (PATCH …/permissions); pass --grant/--revoke. +Grants access: asks before it is sent (--yes to skip). It asks even when the body only +takes rights away: the mark is of the operation. + **Usage**: ```console @@ -4741,7 +4750,7 @@ $ ycli tracker entities permissions-update-direct [OPTIONS] ENTITY_TYPE ID * `--grant TEXT`: Rights to add as JSON, e.g. '{"READ":{"users":["ann"]}}'. * `--revoke TEXT`: Rights to remove as JSON, e.g. '{"GRANT":{"roles":["OWNER"]}}'. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4768,7 +4777,7 @@ $ ycli tracker entities update-bulk [OPTIONS] ENTITY_TYPE * `--comment TEXT`: Comment to add to every entity. * `-F, --field TEXT`: Field to set on every entity: key=value (JSON-coerced; repeatable). key[sub]=value nests, and key=@FILE (@- for stdin) gives the file's text; a string that starts with @ goes in JSON quotes. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `--body-file FILE`: A JSON object (YAML in a .yaml / .yml file) laid under the request body: -F and the command's flags win over it. Objects merge; a list is replaced, not added to. YAML guesses types (no, 1.10): quote a value meant as text. @@ -4791,7 +4800,7 @@ $ ycli tracker entities bulk-get [OPTIONS] BULK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4815,7 +4824,7 @@ $ ycli tracker entities reports-create [OPTIONS] * `--type TEXT`: Export type: issueFilterExport. [required] * `-F, --field TEXT`: Issue field key to include as a column (repeatable). [required] * `--format TEXT`: Export format. Known values: xlsx, xml, csv. -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `--body-file FILE`: A JSON object (YAML in a .yaml / .yml file) laid under the request body: -F and the command's flags win over it. Objects merge; a list is replaced, not added to. YAML guesses types (no, 1.10): quote a value meant as text. @@ -4868,7 +4877,7 @@ $ ycli tracker entities comments list [OPTIONS] ENTITY_TYPE ID * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `--expand TEXT`: Extra blocks to include in the reply. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4895,7 +4904,7 @@ $ ycli tracker entities comments get [OPTIONS] ENTITY_TYPE ID COMMENT_ID * `--expand TEXT`: Extra blocks to include in the reply. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4926,7 +4935,7 @@ $ ycli tracker entities comments create [OPTIONS] ENTITY_TYPE ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4957,7 +4966,7 @@ $ ycli tracker entities comments update [OPTIONS] ENTITY_TYPE ID COMMENT_ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -4985,7 +4994,7 @@ $ ycli tracker entities comments delete [OPTIONS] ENTITY_TYPE ID COMMENT_ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5038,7 +5047,7 @@ $ ycli tracker entities checklists create [OPTIONS] ENTITY_TYPE ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5071,7 +5080,7 @@ $ ycli tracker entities checklists update [OPTIONS] ENTITY_TYPE ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5106,7 +5115,7 @@ $ ycli tracker entities checklists items-update [OPTIONS] ENTITY_TYPE ID ITEM_ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5136,7 +5145,7 @@ $ ycli tracker entities checklists items-delete [OPTIONS] ENTITY_TYPE ID ITEM_ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5165,7 +5174,7 @@ $ ycli tracker entities checklists delete [OPTIONS] ENTITY_TYPE ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5196,7 +5205,7 @@ $ ycli tracker entities checklists move [OPTIONS] ENTITY_TYPE ID ITEM_ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5242,7 +5251,7 @@ $ ycli tracker entities links list [OPTIONS] ENTITY_TYPE ID * `--fields TEXT`: Comma-separated fields to include in the reply. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5269,7 +5278,7 @@ $ ycli tracker entities links create [OPTIONS] ENTITY_TYPE ID * `--relationship TEXT`: Link type, e.g. relates, depends on. [required] * `--entity TEXT`: Id of the entity to link to. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5295,7 +5304,7 @@ $ ycli tracker entities links delete [OPTIONS] ENTITY_TYPE ID RIGHT **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5342,7 +5351,7 @@ $ ycli tracker entities attachments list [OPTIONS] ENTITY_TYPE ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5368,7 +5377,7 @@ $ ycli tracker entities attachments get [OPTIONS] ENTITY_TYPE ID FILE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5394,7 +5403,7 @@ $ ycli tracker entities attachments download [OPTIONS] FILE_ID FILENAME * `-O, --output TEXT`: Write to this path; omit or '-' for stdout. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5424,7 +5433,7 @@ $ ycli tracker entities attachments attach [OPTIONS] ENTITY_TYPE ID TEMP_FILE_ID * `--notify / --no-notify`: Notify the users in the fields of the object (the API notifies by default). * `--notify-author / --no-notify-author`: Notify the author of the change (the API does not by default). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5450,7 +5459,7 @@ $ ycli tracker entities attachments delete [OPTIONS] ENTITY_TYPE ID FILE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5494,7 +5503,7 @@ $ ycli tracker workflows list [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5518,7 +5527,7 @@ $ ycli tracker workflows get [OPTIONS] WORKFLOW_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5542,7 +5551,7 @@ $ ycli tracker workflows list-for-queue [OPTIONS] QUEUE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5574,7 +5583,7 @@ $ ycli tracker workflows create [OPTIONS] * `--visual`: Send type VISUAL (the only type today). * `--issue-type-resolution TEXT`: Resolutions of an issue type, e.g. '{"issueType":"task","resolutions":["fixed"]}' (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5606,7 +5615,7 @@ $ ycli tracker workflows update [OPTIONS] WORKFLOW_ID * `--visual`: Send type VISUAL (the only type today). * `--issue-type-resolution TEXT`: Resolutions of an issue type, e.g. '{"issueType":"task","resolutions":["fixed"]}' (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5634,7 +5643,7 @@ $ ycli tracker workflows actions-update [OPTIONS] WORKFLOW_ID STATUS ACTION_ID * `--version INTEGER`: Current version of the workflow (optimistic lock); see `workflows get`. [required] * `--action TEXT`: Action fields as a JSON object; Tracker requires name and target, e.g. '{"name":{"ru":"Закрыть"},"target":"closed"}'. [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5658,7 +5667,7 @@ $ ycli tracker workflows delete [OPTIONS] WORKFLOW_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5702,7 +5711,7 @@ $ ycli tracker projects list [OPTIONS] * `--expand TEXT`: Extra blocks to include, e.g. queues. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5727,7 +5736,7 @@ $ ycli tracker projects get [OPTIONS] PROJECT_ID * `--expand TEXT`: Extra blocks to include, e.g. queues. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5752,7 +5761,7 @@ $ ycli tracker projects queues-list [OPTIONS] PROJECT_ID * `--expand TEXT`: Extra queue blocks, e.g. all or components,versions. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5781,7 +5790,7 @@ $ ycli tracker projects create [OPTIONS] * `--start-date TEXT`: Start date (YYYY-MM-DD). * `--end-date TEXT`: End date (YYYY-MM-DD). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5814,7 +5823,7 @@ $ ycli tracker projects update [OPTIONS] PROJECT_ID * `--end-date TEXT`: End date (YYYY-MM-DD). * `--expand TEXT`: Extra blocks to include, e.g. queues. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5838,7 +5847,7 @@ $ ycli tracker projects delete [OPTIONS] PROJECT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5888,7 +5897,7 @@ $ ycli tracker gaps create [OPTIONS] * `--work-in-absence / --no-work-in-absence`: Whether the user works. * `--gap TEXT`: More absences as JSON objects of the API docs (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5917,7 +5926,7 @@ $ ycli tracker gaps search [OPTIONS] USER... * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -5941,7 +5950,7 @@ $ ycli tracker gaps delete [OPTIONS] GAP_ID... **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. diff --git a/docs/en/reference/cli/wiki.md b/docs/en/reference/cli/wiki.md index 2f58f089a..ee59306b5 100644 --- a/docs/en/reference/cli/wiki.md +++ b/docs/en/reference/cli/wiki.md @@ -64,7 +64,7 @@ $ ycli wiki auth status [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -102,7 +102,7 @@ $ ycli wiki me get [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -160,7 +160,7 @@ $ ycli wiki pages get [OPTIONS] SLUG * `--revision-id INTEGER`: Show this past revision (ids from `revisions-list`). * `--raise-on-redirect / --no-raise-on-redirect`: Fail if the page is a redirect, do not follow it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -184,7 +184,7 @@ $ ycli wiki pages get-meta [OPTIONS] SLUG **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -214,7 +214,7 @@ $ ycli wiki pages descendants-list [OPTIONS] SLUG * `--show-all / --no-show-all`: The API's show_all flag. * `--actuality TEXT`: Only the pages in this state: actual or obsolete. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -241,7 +241,7 @@ $ ycli wiki pages get-by-id [OPTIONS] PAGE_ID * `--revision-id INTEGER`: Show this past revision (ids from `revisions-list`). * `--raise-on-redirect / --no-raise-on-redirect`: Fail if the page is a redirect, do not follow it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -271,7 +271,7 @@ $ ycli wiki pages descendants-list-by-id [OPTIONS] PAGE_ID * `--show-all / --no-show-all`: The API's show_all flag. * `--actuality TEXT`: Only the pages in this state: actual or obsolete. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -300,7 +300,7 @@ $ ycli wiki pages grids-list [OPTIONS] PAGE_ID * `--order-by TEXT`: Sort field. Known values: title, created_at. * `--order-direction TEXT`: Sort direction for --order-by. Known values: asc, desc. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -325,7 +325,7 @@ $ ycli wiki pages create [OPTIONS] * `--fields TEXT`: Comma-separated blocks to include in the reply. * `--is-silent / --no-is-silent`: Do not notify the page's subscribers. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -354,7 +354,7 @@ $ ycli wiki pages update [OPTIONS] PAGE_ID * `--is-silent / --no-is-silent`: Do not notify the page's subscribers. * `--allow-merge / --no-allow-merge`: Merge with a concurrent edit instead of failing. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -379,7 +379,7 @@ $ ycli wiki pages delete [OPTIONS] PAGE_ID * `--recursive / --no-recursive`: Also delete every page under it. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -410,7 +410,7 @@ $ ycli wiki pages append [OPTIONS] PAGE_ID * `--fields TEXT`: Comma-separated blocks to include in the reply. * `--is-silent / --no-is-silent`: Do not notify the page's subscribers. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -438,7 +438,7 @@ $ ycli wiki pages clone [OPTIONS] PAGE_ID * `--subscribe-me / --no-subscribe-me`: Subscribe yourself to the copy. * `--wait / --no-wait`: Poll to a terminal status before printing. [default: wait] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -468,7 +468,7 @@ $ ycli wiki pages move [OPTIONS] SOURCE TARGET * `--validate-only / --no-validate-only`: Validate the move without applying it (nothing to wait for). * `--wait / --no-wait`: Poll to a terminal status before printing. [default: wait] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -496,7 +496,7 @@ $ ycli wiki pages revisions-list [OPTIONS] PAGE_ID * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -525,7 +525,7 @@ $ ycli wiki pages backlinks-list [OPTIONS] PAGE_ID * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -564,7 +564,7 @@ $ ycli wiki pages search [OPTIONS] QUERY * `--limit INTEGER`: Results per page. * `--cursor INTEGER`: Result page to fetch, from 1 (see next_cursor). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -599,6 +599,8 @@ Grant a user or a group a role on a page (POST /pages/{id}/access). Name the user with --user-uid / --user-cloud-uid, or the group with --group-src and --group-id. +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -618,7 +620,7 @@ $ ycli wiki access create [OPTIONS] PAGE_ID * `--group-id TEXT`: Id of the group to grant in that directory. * `--inheritance TEXT`: Whether the access also covers subpages. Known values: inherited, not_inherited. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -629,6 +631,8 @@ $ ycli wiki access create [OPTIONS] PAGE_ID Change the role or reach of an access (POST /pages/{id}/access/{access_id}). +Grants access: asks before it is sent (--yes to skip). + **Usage**: ```console @@ -646,7 +650,7 @@ $ ycli wiki access update [OPTIONS] PAGE_ID ACCESS_ID * `--inheritance TEXT`: Whether the access also covers subpages. Known values: inherited, not_inherited. * `--prevent-selflock / --no-prevent-selflock`: Refuse the change if it would leave you without read access or the right to change accesses. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -672,7 +676,7 @@ $ ycli wiki access delete [OPTIONS] PAGE_ID ACCESS_ID * `--prevent-selflock / --no-prevent-selflock`: Refuse the change if it would leave you without read access or the right to change accesses. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -697,7 +701,7 @@ $ ycli wiki access clear [OPTIONS] PAGE_ID * `--prevent-selflock / --no-prevent-selflock`: Refuse the change if it would leave you without read access or the right to change accesses. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -749,7 +753,7 @@ $ ycli wiki comments list [OPTIONS] PAGE_ID * `--order-direction TEXT`: Sort direction for --order-by. Known values: asc, desc. * `--status-filter TEXT`: Only comments in this state. Known values: resolved, unresolved. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -779,7 +783,7 @@ $ ycli wiki comments thread-list [OPTIONS] PAGE_ID COMMENT_ID * `--limit INTEGER RANGE`: Max items to fetch (default: the configured cap). [x>=1] * `--all`: Fetch everything, ignoring the cap. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -810,7 +814,7 @@ $ ycli wiki comments thread-get [OPTIONS] PAGE_ID COMMENT_ID * `--all`: Fetch everything, ignoring the cap. * `--next TOKEN`: Go on from where an earlier run stopped, with the token it printed: the token carries its listing; give what is required again, and nothing else but the limit. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -838,7 +842,7 @@ $ ycli wiki comments create [OPTIONS] PAGE_ID * `--parent-id INTEGER`: Reply to this comment id (threaded). * `--thread-id INTEGER`: File into this existing thread id. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -863,7 +867,7 @@ $ ycli wiki comments delete [OPTIONS] PAGE_ID COMMENT_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -917,7 +921,7 @@ $ ycli wiki attachments list [OPTIONS] PAGE_ID * `--order-by TEXT`: Sort field. Known values: name, size, created_at. * `--order-direction TEXT`: Sort direction for --order-by. Known values: asc, desc. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -942,7 +946,7 @@ $ ycli wiki attachments get [OPTIONS] PAGE_ID FILE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -971,7 +975,7 @@ $ ycli wiki attachments previews-download [OPTIONS] PAGE_ID FILE_ID * `--output TEXT`: Write bytes to this path; omit / '-' streams to stdout. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -997,7 +1001,7 @@ $ ycli wiki attachments download [OPTIONS] PAGE_ID FILE_ID * `--output TEXT`: Write bytes to this path; omit / '-' streams to stdout. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1022,7 +1026,7 @@ $ ycli wiki attachments download-by-url [OPTIONS] URL * `--output TEXT`: Write bytes to this path; omit / '-' streams to stdout. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1047,7 +1051,7 @@ $ ycli wiki attachments delete [OPTIONS] PAGE_ID FILE_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1072,7 +1076,7 @@ $ ycli wiki attachments attach [OPTIONS] PAGE_ID * `--session-ids TEXT`: Finished upload-session id to attach (repeatable). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1097,7 +1101,7 @@ $ ycli wiki attachments upload [OPTIONS] PAGE_ID FILE_PATH **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1146,7 +1150,7 @@ $ ycli wiki resources list [OPTIONS] PAGE_ID * `--order-by TEXT`: Sort field. Known values: name_title, created_at. * `--order-direction TEXT`: Sort direction for --order-by. Known values: asc, desc. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1188,7 +1192,7 @@ $ ycli wiki recovery recover [OPTIONS] TOKEN **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1243,7 +1247,7 @@ $ ycli wiki grids get [OPTIONS] GRID_ID * `--revision TEXT`: Load a historical revision. * `--sort TEXT`: Row sort, e.g. slug,-slug2. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1266,7 +1270,7 @@ $ ycli wiki grids create [OPTIONS] * `--page-slug TEXT`: Target page slug, e.g. data/x. * `--page-id INTEGER`: Target page numeric id. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1296,7 +1300,7 @@ $ ycli wiki grids update [OPTIONS] GRID_ID * `--title TEXT`: New grid title. * `--default-sort TEXT`: New default sort as JSON in the write shape '[{"": "asc"|"desc"}]', e.g. '[{"priority": "desc"}]'. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1320,7 +1324,7 @@ $ ycli wiki grids delete [OPTIONS] GRID_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1348,7 +1352,7 @@ $ ycli wiki grids clone [OPTIONS] GRID_ID * `--with-data / --no-with-data`: Copy the rows too, not just the structure. * `--wait / --no-wait`: Poll to a terminal status before printing. [default: wait] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1397,7 +1401,7 @@ $ ycli wiki grids rows create [OPTIONS] GRID_ID * `--position INTEGER`: Zero-based target index. * `--after-row-id TEXT`: Insert after this row id. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1423,7 +1427,7 @@ $ ycli wiki grids rows delete [OPTIONS] GRID_ID * `--row-id TEXT`: Row id to delete (repeatable). [required] * `--revision TEXT`: Grid revision the edit is based on. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1452,7 +1456,7 @@ $ ycli wiki grids rows move [OPTIONS] GRID_ID * `--position INTEGER`: Zero-based target index. * `--rows-count INTEGER`: How many consecutive rows to move. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1480,7 +1484,7 @@ $ ycli wiki grids rows update [OPTIONS] GRID_ID ROW_ID * `--pinned / --no-pinned`: Pin or unpin the row. * `--color TEXT`: Row background colour. Known values: blue, yellow, pink, red, green, mint, grey, orange, magenta, purple, copper, ocean. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1531,7 +1535,7 @@ $ ycli wiki grids columns create [OPTIONS] GRID_ID * `--revision TEXT`: Grid revision the edit is based on. * `--position INTEGER`: Zero-based target index. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1557,7 +1561,7 @@ $ ycli wiki grids columns delete [OPTIONS] GRID_ID * `--column-slug TEXT`: Column slug to delete (repeatable). [required] * `--revision TEXT`: Grid revision the edit is based on. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1585,7 +1589,7 @@ $ ycli wiki grids columns move [OPTIONS] GRID_ID * `--revision TEXT`: Grid revision the edit is based on. * `--columns-count INTEGER`: How many consecutive columns to move. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1613,7 +1617,7 @@ $ ycli wiki grids columns suggest [OPTIONS] GRID_ID * `--title TEXT`: Title to turn into a slug and check. * `--slug TEXT`: Slug to check. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1649,7 +1653,7 @@ $ ycli wiki grids columns update [OPTIONS] GRID_ID COLUMN_SLUG * `--color TEXT`: Column background colour. Known values: blue, yellow, pink, red, green, mint, grey, orange, magenta, purple, copper, ocean. * `--select-option TEXT`: Allowed choice of a select column (repeatable). * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1693,7 +1697,7 @@ $ ycli wiki grids cells update [OPTIONS] GRID_ID * `--cells TEXT`: Cells as JSON, e.g. '[{"row_id":1,"column_slug":"name","value":"x"}]'. [required] * `--revision TEXT`: Grid revision the edit is based on. * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1737,7 +1741,7 @@ $ ycli wiki operations clone-get [OPTIONS] TASK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1761,7 +1765,7 @@ $ ycli wiki operations clone-inline-grid-get [OPTIONS] TASK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1785,7 +1789,7 @@ $ ycli wiki operations move-get [OPTIONS] TASK_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1830,7 +1834,7 @@ $ ycli wiki uploadsessions create [OPTIONS] * `--file-name TEXT`: Name to give the uploaded file. [required] * `--file-size INTEGER`: Total file size in bytes (sum of all parts). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1854,7 +1858,7 @@ $ ycli wiki uploadsessions get [OPTIONS] SESSION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1880,7 +1884,7 @@ $ ycli wiki uploadsessions parts-upload [OPTIONS] SESSION_ID FILE_PATH * `--part-number INTEGER`: 1-based part index (1 for the first part, +1 per next part). [required] * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1904,7 +1908,7 @@ $ ycli wiki uploadsessions finish [OPTIONS] SESSION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1928,7 +1932,7 @@ $ ycli wiki uploadsessions abort [OPTIONS] SESSION_ID **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. @@ -1948,7 +1952,7 @@ $ ycli wiki uploadsessions abort-all [OPTIONS] **Options**: * `-o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]`: Output format (auto = pretty on a TTY, JSON when piped). -* `-y, --yes`: Do not ask before an operation that deletes data. +* `-y, --yes`: Do not ask before an operation that deletes data or grants access. * `--dry-run`: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***. * `--profile NAME`: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. `ycli auth profiles` lists them. * `-F, --field TEXT`: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret. diff --git a/docs/en/reference/mcp/datalens.md b/docs/en/reference/mcp/datalens.md index 613029184..7a5d0a792 100644 --- a/docs/en/reference/mcp/datalens.md +++ b/docs/en/reference/mcp/datalens.md @@ -165,6 +165,8 @@ Delete several collections with everything they hold. Give or take away roles on a collection; the roles not named stay as they are. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `collection_id` | string | yes | Collection id. | @@ -327,6 +329,8 @@ Delete several workbooks with everything they hold. Give or take away roles on a workbook; the roles not named stay as they are. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `workbook_id` | string | yes | Workbook id. | @@ -1260,6 +1264,8 @@ Embed an entry and return the embed. The key for embedding is one of the workbook the entry lies in (``embeddingsecrets_list``). +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `title` | string | yes | The name of the embed. | @@ -1280,6 +1286,8 @@ Save an embed as given and return it. The embed is replaced whole: read it with ``embeds_list`` and send back what is to stay; a list left out is saved empty. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `embed_id` | string | yes | Embed id, from ``embeds_list``. | @@ -1331,6 +1339,8 @@ The private key is given once: ``embeddingsecrets_get`` and ``embeddingsecrets_l return it. It comes in this tool's result, so it enters your context: hand it to the person at once, and do not repeat it in later messages. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `title` | string | yes | The name of the key. | @@ -1370,6 +1380,8 @@ Give or take away roles on a shared entry; the roles not named stay as they are. The roles are ``datalens.sharedEntries.*`` (``viewer``, ``admin``, …). +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `entry_id` | string | yes | Id of a shared entry: one that lies in a collection. | @@ -1506,6 +1518,8 @@ Give each of these users a licence and return the licences given. A licence is a seat DataLens bills for: ask the person before calling. Written from the DataLens document and never called: not measured. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `user_ids` | array of string | yes | The users to give a licence to. | diff --git a/docs/en/reference/mcp/forms.md b/docs/en/reference/mcp/forms.md index 44a26799c..b5711f474 100644 --- a/docs/en/reference/mcp/forms.md +++ b/docs/en/reference/mcp/forms.md @@ -525,6 +525,8 @@ organization) or public (anyone with the link). Set the access level of one action (change or submit); returns every permission. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | @@ -538,6 +540,8 @@ Let a user or a group perform an action on a form; returns every permission. Granting someone who already has the action changes nothing. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | diff --git a/docs/en/reference/mcp/tracker.md b/docs/en/reference/mcp/tracker.md index 4f9ed99fb..0535d3a1c 100644 --- a/docs/en/reference/mcp/tracker.md +++ b/docs/en/reference/mcp/tracker.md @@ -954,6 +954,8 @@ addition: taking a user out of ``read`` took it out of ``write`` too (seen once, 2026-10-06), so read the returned set after a removal. Adding a member that is there already changes nothing. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | @@ -2128,6 +2130,8 @@ actions, each mapping an access level (``READ``/``WRITE``/``GRANT``) to users/gr e.g. ``{"acl": {"grant": {"READ": {"users": ["8000000000000002"]}}}}``. Read the current ACL first with ``entities_permissions_get``. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | @@ -2144,6 +2148,8 @@ Grant and revoke an entity's direct rights; the rest stay as they are. ``groups`` (ids) and ``roles`` (AUTHOR, OWNER, CLIENT, FOLLOWER, MEMBER). Returns the resulting rights. Read them first with ``entities_permissions_get_direct``. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | diff --git a/docs/en/reference/mcp/wiki.md b/docs/en/reference/mcp/wiki.md index 78cc50015..b78340883 100644 --- a/docs/en/reference/mcp/wiki.md +++ b/docs/en/reference/mcp/wiki.md @@ -277,6 +277,8 @@ A user who already holds a personal access is refused: change it with ``access_u Read the current accesses with ``pages_get_by_id`` and ``fields="access_policy,access_lists"``. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page. | @@ -290,6 +292,8 @@ Change the role or reach of one access entry on a wiki page. The page owner's own entry cannot be changed. +Grants access: a client that honours the mark asks a person on every call. + | Parameter | Type | Required | Description | |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page. | diff --git a/docs/ru/how-to/script-the-cli.md b/docs/ru/how-to/script-the-cli.md index 213563bee..e816abdcb 100644 --- a/docs/ru/how-to/script-the-cli.md +++ b/docs/ru/how-to/script-the-cli.md @@ -71,14 +71,17 @@ $ ycli tracker issues search 'Queue: DE' --limit 100 --next eyJ2IjoxLCJvZiI6… Токен несёт свой список: с `--next` задают только лимит и то, без чего команду не вызвать, причём таким же, как было: аргумент, который расходится с токеном, получает отказ с его именем, а не отбрасывается молча. Токен поиска задач Трекера с прокруткой (`--scroll-type`) работает один раз; любой другой токен можно использовать повторно. В нём лежит и собственный токен прокрутки, поэтому `ycli tracker issues scroll-clear --next TOKEN` освобождает прокрутку до истечения её срока; этот токен бесполезен без ваших учётных данных и перестаёт действовать вместе с прокруткой. Токен продолжает список только в той организации, где он получен: под другой учётной записью будет отказ, а не запуск. Список, который уже нельзя продолжить, завершается кодом `9`: начните его заново без токена. Запуск, которому нужно больше страниц, чем `YCLI__HTTP__MAX_PAGES`, останавливается на этом пределе и говорит об этом так же, с токеном для продолжения. Маленький первый `--limit` задаёт размер страниц для всех следующих частей, поэтому берите первую часть такой же величины, какими собираетесь продолжать. -## Удаление без запроса подтверждения +## Удаление и выдача доступа без запроса подтверждения -Команда, которая уничтожает данные, в терминале просит подтверждения. В скрипте спросить некого, поэтому она завершается с кодом 2, пока вы не передадите `--yes` / `-y`: +Команда, которая уничтожает данные или выдаёт доступ (роль на форме или странице, права очереди, привязка доступа или встраивание в DataLens), в терминале просит подтверждения. В скрипте спросить некого, поэтому она завершается с кодом 2, пока вы не передадите `--yes` / `-y`: ```bash ycli tracker boards delete 7 --yes +ycli wiki access create 7 --role reader --user-uid 9001 --yes ``` +О том, что команда выдаёт доступ, сказано в её справке. `--dry-run` ни о чём не спрашивает: он ничего не отправляет. + ## Предпросмотр записи `--dry-run` ничего не записывает, а печатает запрос (метод, URL, тело — но никогда не токен) в том же формате `-o`, и завершается с кодом 0. Секрет в теле, например пароль подключения DataLens, печатается как `***`, поэтому вывод безопасен в логе CI. Такое значение давайте из файла вне репозитория с правами 600: через `--body-file` или одним полем через `-F password=@secret.txt`. Набранное в командной строке, оно остаётся в истории оболочки. Файл одного поля пишите без перевода строки в конце (`printf %s 'секрет' > secret.txt`), иначе перевод строки уйдёт вместе с секретом. Чтения всё равно выполняются, поэтому команда, которая сначала читает, а потом пишет, покажет только свою первую запись. diff --git a/docs/ru/how-to/use-in-ci.md b/docs/ru/how-to/use-in-ci.md index d277e2521..59fd02025 100644 --- a/docs/ru/how-to/use-in-ci.md +++ b/docs/ru/how-to/use-in-ci.md @@ -61,7 +61,7 @@ docker run --rm -e YANDEX_ID_OAUTH_TOKEN -e YANDEX_ID_ORGANIZATION_ID \ ## Команды, которые не ждут -- **Для удаления нужен `--yes`.** Команда, которая уничтожает данные, просит подтверждения; без терминала она вместо этого завершается с кодом 2. Передайте `--yes`, если конвейер должен удалять. +- **Для удаления и выдачи доступа нужен `--yes`.** Команда, которая уничтожает данные или выдаёт доступ (роль на форме или странице, права очереди или сущности, привязка доступа, лицензия или встраивание в DataLens), просит подтверждения; без терминала она вместо этого завершается с кодом 2. Передайте `--yes`, если конвейер должен это делать. О том, что команда выдаёт доступ, сказано в её справке. - **Вывод — JSON.** Без терминала ycli печатает JSON, поэтому его читает `jq`: `ycli tracker issues get TRACKER-1 | jq .key`. - **Сначала попробуйте.** `--dry-run` печатает запрос, который отправила бы запись, и ничего не отправляет. diff --git a/plugins/yandex-360/skills/yandex-360/SKILL.md b/plugins/yandex-360/skills/yandex-360/SKILL.md index c82de6fcc..ed1eecb67 100644 --- a/plugins/yandex-360/skills/yandex-360/SKILL.md +++ b/plugins/yandex-360/skills/yandex-360/SKILL.md @@ -113,9 +113,12 @@ semantics, a service ycli does not wrap yet), read the official docs directly, a - **Never hardcode the token or org id** — always read them from the environment. - **Respect the MCP annotations** — write tools declare `readOnlyHint=False`; anything - with `destructiveHint=true` deletes data, so confirm intent before calling it. If the + with `destructiveHint=true` deletes data, so confirm intent before calling it. A tool that + grants access (a role, a permission, an access binding, an embedding) says so in its + description and is marked so that the client asks a person on every call; where nobody can + be asked the call is denied, and the CLI with `--yes` is the way, after the user agreed. If the session must not write at all, run the server with `ycli mcp start --read-only`. -- **CLI deletes ask first** — a command that deletes data prompts on a terminal and, without +- **CLI deletes and grants ask first** — a command that deletes data or grants access prompts on a terminal and, without one (an agent's shell), exits 2 unless given `--yes`; confirm intent with the user before adding it. `--dry-run` prints the write request instead of sending it, the JSON result pipes to `jq`, and the exit code says what failed (3 not found, 4 auth, 5 rate limited, diff --git a/src/ycli/cli/api.py b/src/ycli/cli/api.py index 9dbae0c4d..db69bac29 100644 --- a/src/ycli/cli/api.py +++ b/src/ycli/cli/api.py @@ -6,6 +6,8 @@ through the normal output path, so ``-o``, ``--yes`` and ``--dry-run`` work as they do everywhere. The request is an :class:`~ycli.yandex.core.endpoint.Endpoint` sent through the service's own client, so its effect follows the method: a ``DELETE`` asks for ``--yes``. +Nothing here says that a path grants access, so a grant sent this way is not asked about: the +commands of the resources are, each by the mark of its operation. """ from __future__ import annotations diff --git a/src/ycli/cli/guard.py b/src/ycli/cli/guard.py index 9af312422..608ba177d 100644 --- a/src/ycli/cli/guard.py +++ b/src/ycli/cli/guard.py @@ -5,9 +5,9 @@ - ``--dry-run`` sends no write: the core stops at the first one, and the command wrapper turns the request it would have sent into the command's result; -- an operation that destroys data asks first, unless ``--yes`` was given: on a terminal it - prompts on stderr, and a declined prompt aborts (exit 1); with no terminal to ask it fails as a - usage error (exit 2) that says to pass ``--yes``; +- an operation that destroys data, or grants access, asks first, unless ``--yes`` was given: + on a terminal it prompts on stderr, and a declined prompt aborts (exit 1); with no terminal + to ask it fails as a usage error (exit 2) that says to pass ``--yes``; - ``--body-file`` and ``-F`` reach the body of any command: :class:`SendGuard`, the client's ``before_send`` hook, lays them under what the command built, so a field with no flag of its own can still be sent. It runs before the core's rule, so a plan shows the body as it would go. @@ -40,6 +40,10 @@ def attended() -> bool: return sys.stdin.isatty() and sys.stdout.isatty() +#: What the help of a command that grants access says of it, the same on each of them. +GRANTS_ACCESS_HELP = "Grants access: asks before it is sent (--yes to skip)." + + def confirm_on_the_terminal(plan: PlannedRequest) -> bool: """Ask the person at the terminal whether ``plan`` may be sent. @@ -52,7 +56,8 @@ def confirm_on_the_terminal(plan: PlannedRequest) -> bool: Raises: typer.Exit: Nobody can be asked; exits as a usage error that says to pass ``--yes``. """ - what = f"{plan.method} {plan.url} — this deletes data." + does = "grants access" if plan.grants_access else "deletes data" + what = f"{plan.method} {plan.url} — this {does}." if not attended(): typer.secho( f"{what} Pass --yes to confirm; there is no terminal to ask on.", diff --git a/src/ycli/cli/typedefs.py b/src/ycli/cli/typedefs.py index bdac10fb6..cc86b4438 100644 --- a/src/ycli/cli/typedefs.py +++ b/src/ycli/cli/typedefs.py @@ -36,7 +36,9 @@ ] YesOption = Annotated[ bool, - typer.Option("--yes", "-y", help="Do not ask before an operation that deletes data."), + typer.Option( + "--yes", "-y", help="Do not ask before an operation that deletes data or grants access." + ), ] ProfileOption = Annotated[ str | None, diff --git a/src/ycli/mcp/listing.py b/src/ycli/mcp/listing.py index 5d18f011b..702496962 100644 --- a/src/ycli/mcp/listing.py +++ b/src/ycli/mcp/listing.py @@ -14,7 +14,13 @@ from fastmcp.server.transforms import Transform from fastmcp.server.transforms.visibility import is_enabled -from ycli.yandex.mcp import NEEDS_TOOLS, REPEATS_TOOL, WRITE_TAG +from ycli.yandex.mcp import ( + GRANTS_ACCESS, + GRANTS_ACCESS_SAID, + NEEDS_TOOLS, + REPEATS_TOOL, + WRITE_TAG, +) if TYPE_CHECKING: from collections.abc import Awaitable, Callable, Sequence @@ -148,6 +154,33 @@ async def get_tool( return None if tool is None else self._tagged(tool) +class GrantsSaid(Transform): + """Says in the description of a tool that grants access what its mark says to a client. + + The mark (``GRANTS_ACCESS``) is a key one client reads; the others pass it by, and for them + the words are all there is. One sentence, from one place, on every marked tool. + """ + + @staticmethod + def _said(tool: Tool) -> Tool: + marked = (tool.meta or {}).get(next(iter(GRANTS_ACCESS))) is True + if not marked or GRANTS_ACCESS_SAID in (tool.description or ""): + return tool + described = f"{tool.description or ''}\n\n{GRANTS_ACCESS_SAID}".strip() + return tool.model_copy(update={"description": described}) + + async def list_tools(self, tools: Sequence[Tool]) -> Sequence[Tool]: + """The tools, each marked one saying so in its description.""" + return [self._said(tool) for tool in tools] + + async def get_tool( + self, name: str, call_next: GetToolNext, *, version: VersionSpec | None = None + ) -> Tool | None: + """The tool ``name``, saying so in its description when it is marked.""" + tool = await call_next(name, version=version) + return None if tool is None else self._said(tool) + + class UnknownToolError(ValueError): """A tool name in the selection that no mounted service serves.""" diff --git a/src/ycli/mcp/server.py b/src/ycli/mcp/server.py index 2a3302443..2a477009e 100644 --- a/src/ycli/mcp/server.py +++ b/src/ycli/mcp/server.py @@ -8,12 +8,22 @@ from __future__ import annotations import asyncio -from typing import TYPE_CHECKING +from typing import TYPE_CHECKING, Annotated, Any +from fastmcp import Context # noqa: TC002 # read at run time: FastMCP resolves the proxy's hints +from fastmcp.exceptions import ToolError from fastmcp.server.transforms.search import BM25SearchTransform +from fastmcp.tools import Tool +from fastmcp.tools.base import ToolResult # noqa: TC002 # the same from pydantic import ValidationError -from ycli.mcp.listing import DerivedTags, LightListing, ServedWithTheirTools, UnknownToolError +from ycli.mcp.listing import ( + DerivedTags, + GrantsSaid, + LightListing, + ServedWithTheirTools, + UnknownToolError, +) from ycli.mcp.profiles import ALWAYS_SERVED from ycli.mcp.schemas import schema_server from ycli.mcp.selection import Selection @@ -24,11 +34,13 @@ MCPHTTPConfig, OAuthAppConfig, ) -from ycli.yandex.mcp import WRITE_TAG, guide, new_server +from ycli.yandex.mcp import GRANTS_ACCESS, WRITE_TAG, guide, new_server from ycli.yandex.registry import SERVICES, about from ycli.yandex.status.mcp import mcp as status_mcp if TYPE_CHECKING: + from collections.abc import Sequence + from fastmcp import FastMCP from fastmcp.server.auth import AuthProvider @@ -76,10 +88,62 @@ def root_guide() -> str: server.mount(status_mcp, namespace="status") server.mount(schema_server(server.list_tools, server.get_tool), namespace="schema") server.add_transform(DerivedTags()) + server.add_transform(GrantsSaid()) _apply_selection(server, selection) return server +#: What the proxy of the tool search answers when asked to run a tool that grants access. +BY_ITS_OWN_NAME = ( + "this tool grants access: call it by its own name, so that the client can ask a person" +) + + +def _grants_access(tool: Tool) -> bool: + """Whether ``tool`` carries the mark of an operation that grants access.""" + return all((tool.meta or {}).get(key) is value for key, value in GRANTS_ACCESS.items()) + + +class _Search(BM25SearchTransform): + """The tool search, with the tools that grants access left in the listing. + + A client reads the mark of such a tool from the tool's own entry and asks a person. Behind + the search there is no entry, and the proxy that runs what the search found carries no + mark: nobody would be asked. So a marked tool stays listed, the search does not offer it, + and the proxy refuses to run it. Which tools those are is read from their mark. + """ + + async def transform_tools(self, tools: Sequence[Tool]) -> Sequence[Tool]: + """The pinned tools, the marked ones, and the search and its proxy.""" + listed = await super().transform_tools(tools) + there = {tool.name for tool in listed} + marked = [tool for tool in tools if _grants_access(tool) and tool.name not in there] + return [*marked, *listed] + + async def _get_visible_tools(self, ctx: Context) -> Sequence[Tool]: + """What the search looks through: nothing the proxy would refuse.""" + found = await super()._get_visible_tools(ctx) + return [tool for tool in found if not _grants_access(tool)] + + def _make_call_tool(self) -> Tool: + """The proxy of FastMCP, which first looks at the mark of what it is asked to run.""" + proxy = super()._make_call_tool() + run = proxy.fn # ty: ignore[unresolved-attribute] + + async def call_tool( + name: Annotated[str, "The name of the tool to call"], + arguments: Annotated[dict[str, Any] | None, "Arguments to pass to the tool"] = None, + ctx: Context = None, # ty: ignore[invalid-parameter-default] + ) -> ToolResult: + tool = await ctx.fastmcp.get_tool(name) + if tool is not None and _grants_access(tool): + raise ToolError(BY_ITS_OWN_NAME) + return await run(name, arguments, ctx) + + call_tool.__doc__ = run.__doc__ + return Tool.from_function(fn=call_tool, name=proxy.name) + + def _instructions(mounted: list[Service]) -> str: """What the server tells a client about itself, from the registry: no service is written here. @@ -118,7 +182,7 @@ def _apply_selection(server: FastMCP, selection: Selection) -> None: server.enable(components={"prompt", "resource", "template"}) server.add_transform(ServedWithTheirTools(server.list_tools)) if selection.tool_search: - server.add_transform(BM25SearchTransform(always_visible=[*ALWAYS_SERVED])) + server.add_transform(_Search(always_visible=[*ALWAYS_SERVED])) server.add_transform(LightListing()) # last, so it slims the search tools and their results too diff --git a/src/ycli/yandex/core/endpoint.py b/src/ycli/yandex/core/endpoint.py index 1b0f76078..e112a4b01 100644 --- a/src/ycli/yandex/core/endpoint.py +++ b/src/ycli/yandex/core/endpoint.py @@ -142,7 +142,9 @@ class Endpoint[T]: ``follow_redirects=False`` hands a redirect to ``parser`` instead of following it (a status read that redirects to the finished file). ``effect`` is what the call does to the server: stated explicitly, or implied by the method when left out. An unknown method fails here, at - construction. + construction. ``grants_access`` says the call lets someone at data they could not reach + (a role, a permission, a licence, an embedding): it is asked about before it is sent, like + a call that destroys data, because what it did is not seen afterwards. """ method: HTTPMethod @@ -156,6 +158,7 @@ class Endpoint[T]: headers: Mapping[str, str] = field(default_factory=dict) # Filled at construction when left out: no reader ever sees it empty. effect: Effect = None # ty: ignore[invalid-assignment] + grants_access: bool = False parser: Callable[[httpx2.Response], T] | None = None follow_redirects: bool = True @@ -240,6 +243,7 @@ def RPC[T]( # noqa: N802 - reads as the kind of call it writes, beside ``Endpoi *, json: Any = None, effect: Effect, + grants_access: bool = False, parser: Callable[[httpx2.Response], T] | None = None, ) -> Endpoint[T]: """An operation of an RPC API: ``POST rpc/`` with its arguments in the body. @@ -253,6 +257,7 @@ def RPC[T]( # noqa: N802 - reads as the kind of call it writes, beside ``Endpoi response_type: The type the reply parses into; ``None`` ignores the reply. json: The request body: a request model or plain JSON data. effect: What the call does to the server. + grants_access: Whether the call lets someone at data they could not reach. parser: Reads a reply that is not one JSON type. Returns: @@ -269,6 +274,7 @@ def RPC[T]( # noqa: N802 - reads as the kind of call it writes, beside ``Endpoi response_type, json=json, effect=effect, + grants_access=grants_access, parser=parser, ) diff --git a/src/ycli/yandex/core/guard.py b/src/ycli/yandex/core/guard.py index 44dda3add..b3b01dfb5 100644 --- a/src/ycli/yandex/core/guard.py +++ b/src/ycli/yandex/core/guard.py @@ -7,7 +7,8 @@ - a read goes out; - with ``dry_run`` a write does not: :class:`RequestPlanned` carries the request it would have sent, and the surface shows it in place of a result; -- an operation that destroys data is confirmed first, where there is someone to ask. +- an operation that destroys data, or grants access, is confirmed first, where there is + someone to ask. Examples: >>> import httpx2 @@ -28,7 +29,7 @@ from typing import Any, Self import httpx2 -from pydantic import BaseModel, Field +from pydantic import BaseModel, Field, PrivateAttr from ycli.yandex.core.endpoint import ENDPOINT_EXTENSION, Effect, Endpoint from ycli.yandex.core.session import shown @@ -65,6 +66,14 @@ class PlannedRequest(APIModel): method: str = Field(description="The HTTP method.") url: str = Field(description="The address, with a secret in its query masked.") body: Any = Field(default=None, description="The body, with every secret in it masked.") + # For the one who asks, so the question says what it is about: no field of the plan, so + # it is in no dump of it and in no table. + _grants_access: bool = PrivateAttr(default=False) + + @property + def grants_access(self) -> bool: + """Whether the request grants access, as its operation says.""" + return self._grants_access @classmethod def of(cls, request: httpx2.Request) -> Self: @@ -123,15 +132,16 @@ class Guard: Args: dry_run: Send no write: stop at the first one and show it. - confirm: Asked before an operation that destroys data, with the request about to go - out; ``False`` keeps it from being sent. ``None``: nobody to ask, so it is sent. + confirm: Asked before an operation that destroys data or grants access, with the + request about to go out; ``False`` keeps it from being sent. ``None``: nobody to + ask, so it is sent. """ dry_run: bool = False confirm: Callable[[PlannedRequest], bool] | None = None def check(self, endpoint: Endpoint[Any], request: httpx2.Request) -> None: - """Pass a read; plan a write under ``dry_run``; confirm what destroys data. + """Pass a read; plan a write under ``dry_run``; confirm what destroys or grants. Args: endpoint: The operation about to be sent. @@ -145,9 +155,11 @@ def check(self, endpoint: Endpoint[Any], request: httpx2.Request) -> None: return if self.dry_run: raise RequestPlanned(PlannedRequest.of(request)) - if endpoint.effect is not Effect.DESTRUCTIVE or self.confirm is None: + asked_about = endpoint.effect is Effect.DESTRUCTIVE or endpoint.grants_access + if not asked_about or self.confirm is None: return plan = PlannedRequest.of(request) + plan._grants_access = endpoint.grants_access if not self.confirm(plan): raise YandexDeclinedError( f"{plan.method} {plan.url} was not confirmed; nothing was sent", url=plan.url diff --git a/src/ycli/yandex/datalens/collections/cli.py b/src/ycli/yandex/datalens/collections/cli.py index b50b2fdba..bf3672a3a 100644 --- a/src/ycli/yandex/datalens/collections/cli.py +++ b/src/ycli/yandex/datalens/collections/cli.py @@ -231,6 +231,9 @@ def access_bindings_update( *, datalens: DataLensClient, ) -> Operation: - """Give or take away roles on a collection; the roles not named stay as they are.""" + """Give or take away roles on a collection; the roles not named stay as they are. + + Grants access: asks before it is sent (--yes to skip). + """ parsed = [AccessBindingDelta.model_validate_json(delta) for delta in deltas] return datalens.collections.access_bindings_update(collection_id, deltas=parsed) diff --git a/src/ycli/yandex/datalens/collections/endpoints.py b/src/ycli/yandex/datalens/collections/endpoints.py index e1c93ccdb..960f73fea 100644 --- a/src/ycli/yandex/datalens/collections/endpoints.py +++ b/src/ycli/yandex/datalens/collections/endpoints.py @@ -155,4 +155,10 @@ def access_bindings_update( collection_id: str, *, deltas: Sequence[AccessBindingDelta] ) -> Endpoint[Operation]: body = UpdateCollectionAccessBindingsArgs(collectionId=collection_id, deltas=list(deltas)) - return RPC("updateCollectionAccessBindings", Operation, json=body, effect=Effect.WRITE) + return RPC( + "updateCollectionAccessBindings", + Operation, + json=body, + effect=Effect.WRITE, + grants_access=True, + ) diff --git a/src/ycli/yandex/datalens/collections/mcp.py b/src/ycli/yandex/datalens/collections/mcp.py index bb03c7a9d..f283a1c68 100644 --- a/src/ycli/yandex/datalens/collections/mcp.py +++ b/src/ycli/yandex/datalens/collections/mcp.py @@ -20,6 +20,7 @@ ) from ycli.yandex.datalens.dependencies import ( DESTRUCTIVE, + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -237,6 +238,7 @@ def delete_bulk( @mcp.tool( name="collections_access_bindings_update", annotations={**WRITE, "title": "Change the roles on a DataLens collection"}, + meta=GRANTS_ACCESS, ) def access_bindings_update( collection_id: CollectionID, diff --git a/src/ycli/yandex/datalens/dependencies.py b/src/ycli/yandex/datalens/dependencies.py index 128b529b4..21719abcd 100644 --- a/src/ycli/yandex/datalens/dependencies.py +++ b/src/ycli/yandex/datalens/dependencies.py @@ -7,6 +7,7 @@ from ycli.yandex.datalens.client import DataLensClient from ycli.yandex.mcp import ( DESTRUCTIVE, + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -30,6 +31,7 @@ __all__ = [ "DESTRUCTIVE", + "GRANTS_ACCESS", "LIMIT_CAP", "RO", "TAGS", diff --git a/src/ycli/yandex/datalens/embeddingsecrets/cli.py b/src/ycli/yandex/datalens/embeddingsecrets/cli.py index 66dd6f7fe..941a73f0c 100644 --- a/src/ycli/yandex/datalens/embeddingsecrets/cli.py +++ b/src/ycli/yandex/datalens/embeddingsecrets/cli.py @@ -50,6 +50,8 @@ def create( The private key is given once: `get` and `list` do not return it. Keep it at once, in a file nobody else reads: `ycli -o json datalens embeddingsecrets create … > secret.json`. + + Grants access: asks before it is sent (--yes to skip). """ return datalens.embeddingsecrets.create(title=title, workbook_id=workbook_id) diff --git a/src/ycli/yandex/datalens/embeddingsecrets/endpoints.py b/src/ycli/yandex/datalens/embeddingsecrets/endpoints.py index 9edf29f78..73be977fd 100644 --- a/src/ycli/yandex/datalens/embeddingsecrets/endpoints.py +++ b/src/ycli/yandex/datalens/embeddingsecrets/endpoints.py @@ -34,7 +34,13 @@ def create(*, title: str, workbook_id: str) -> Endpoint[EmbeddingSecretCreated]: # The private key in the reply is the result of the call, given once: it is read as the # string it is, not masked (#448). body = CreateEmbeddingSecretArgs(title=title, workbookId=workbook_id) - return RPC("createEmbeddingSecret", EmbeddingSecretCreated, json=body, effect=Effect.WRITE) + return RPC( + "createEmbeddingSecret", + EmbeddingSecretCreated, + json=body, + effect=Effect.WRITE, + grants_access=True, + ) def delete(embedding_secret_id: str) -> Endpoint[EmbeddingSecretDeleted]: diff --git a/src/ycli/yandex/datalens/embeddingsecrets/mcp.py b/src/ycli/yandex/datalens/embeddingsecrets/mcp.py index 1f4783420..d303f46b4 100644 --- a/src/ycli/yandex/datalens/embeddingsecrets/mcp.py +++ b/src/ycli/yandex/datalens/embeddingsecrets/mcp.py @@ -6,7 +6,14 @@ from pydantic import Field from ycli.yandex.datalens.client import DataLensClient -from ycli.yandex.datalens.dependencies import DESTRUCTIVE, RO, WRITE, datalens_client, new_server +from ycli.yandex.datalens.dependencies import ( + DESTRUCTIVE, + GRANTS_ACCESS, + RO, + WRITE, + datalens_client, + new_server, +) from ycli.yandex.datalens.embeddingsecrets.models import ( EmbeddingSecret, EmbeddingSecretCreated, @@ -44,6 +51,7 @@ def list_( @mcp.tool( name="embeddingsecrets_create", annotations={**WRITE, "title": "Create DataLens key for embedding"}, + meta=GRANTS_ACCESS, ) def create( title: Annotated[str, Field(description="The name of the key.")], diff --git a/src/ycli/yandex/datalens/embeds/cli.py b/src/ycli/yandex/datalens/embeds/cli.py index 51f61e9bc..dec33b1a1 100644 --- a/src/ycli/yandex/datalens/embeds/cli.py +++ b/src/ycli/yandex/datalens/embeds/cli.py @@ -74,7 +74,10 @@ def create( caller: CallerFields, datalens: DataLensClient, ) -> Embed: - """Embed an entry; the title, the key, the entry, the mode and the settings are required.""" + """Embed an entry; the title, the key, the entry, the mode and the settings are required. + + Grants access: asks before it is sent (--yes to skip). + """ given = { "title": title, "embeddingSecretId": embedding_secret_id, @@ -114,7 +117,10 @@ def update( caller: CallerFields, datalens: DataLensClient, ) -> Embed: - """Save an embed as given: the API takes it whole, so name everything that is to stay.""" + """Save an embed as given: the API takes it whole, so name everything that is to stay. + + Grants access: asks before it is sent (--yes to skip). + """ given = { "embedId": embed_id, "title": title, diff --git a/src/ycli/yandex/datalens/embeds/endpoints.py b/src/ycli/yandex/datalens/embeds/endpoints.py index 4667a35cc..dbc18c7c2 100644 --- a/src/ycli/yandex/datalens/embeds/endpoints.py +++ b/src/ycli/yandex/datalens/embeds/endpoints.py @@ -44,7 +44,7 @@ def create( unsignedParams=list(unsigned_params), privateParams=list(private_params), ) - return RPC("createEmbed", Embed, json=body, effect=Effect.WRITE) + return RPC("createEmbed", Embed, json=body, effect=Effect.WRITE, grants_access=True) def update( @@ -69,7 +69,7 @@ def update( unsignedParams=list(unsigned_params), privateParams=list(private_params), ) - return RPC("updateEmbed", Embed, json=body, effect=Effect.IDEMPOTENT_WRITE) + return RPC("updateEmbed", Embed, json=body, effect=Effect.IDEMPOTENT_WRITE, grants_access=True) def delete(embed_id: str) -> Endpoint[EmbedDeleted]: diff --git a/src/ycli/yandex/datalens/embeds/mcp.py b/src/ycli/yandex/datalens/embeds/mcp.py index 05e8bc8e7..2cdf0d4d3 100644 --- a/src/ycli/yandex/datalens/embeds/mcp.py +++ b/src/ycli/yandex/datalens/embeds/mcp.py @@ -8,6 +8,7 @@ from ycli.yandex.datalens.client import DataLensClient from ycli.yandex.datalens.dependencies import ( DESTRUCTIVE, + GRANTS_ACCESS, RO, WRITE, WRITE_IDEMPOTENT, @@ -46,7 +47,11 @@ def list_( return client.embeds.list(entry_id) -@mcp.tool(name="embeds_create", annotations={**WRITE, "title": "Create DataLens embed"}) +@mcp.tool( + name="embeds_create", + annotations={**WRITE, "title": "Create DataLens embed"}, + meta=GRANTS_ACCESS, +) def create( title: Title, embedding_secret_id: SigningSecretID, @@ -74,7 +79,11 @@ def create( ) -@mcp.tool(name="embeds_update", annotations={**WRITE_IDEMPOTENT, "title": "Update DataLens embed"}) +@mcp.tool( + name="embeds_update", + annotations={**WRITE_IDEMPOTENT, "title": "Update DataLens embed"}, + meta=GRANTS_ACCESS, +) def update( embed_id: EmbedID, title: Title, diff --git a/src/ycli/yandex/datalens/licensing/cli.py b/src/ycli/yandex/datalens/licensing/cli.py index 5aad0d12b..85c415621 100644 --- a/src/ycli/yandex/datalens/licensing/cli.py +++ b/src/ycli/yandex/datalens/licensing/cli.py @@ -66,7 +66,10 @@ def licenses_assign( *, datalens: DataLensClient, ) -> ItemList[License]: - """Give each of these users a licence.""" + """Give each of these users a licence. + + Grants access: asks before it is sent (--yes to skip). + """ return datalens.licensing.licenses_assign(user_ids) diff --git a/src/ycli/yandex/datalens/licensing/endpoints.py b/src/ycli/yandex/datalens/licensing/endpoints.py index 94e1f2742..954f06018 100644 --- a/src/ycli/yandex/datalens/licensing/endpoints.py +++ b/src/ycli/yandex/datalens/licensing/endpoints.py @@ -45,7 +45,9 @@ def licenses_list( def licenses_assign(user_ids: Sequence[str]) -> Endpoint[ItemList[License]]: body = AssignLicensesArgs(userIds=list(user_ids)) - return RPC("assignLicenses", ItemList[License], json=body, effect=Effect.WRITE) + return RPC( + "assignLicenses", ItemList[License], json=body, effect=Effect.WRITE, grants_access=True + ) def limit_get() -> Endpoint[LicenseLimits]: diff --git a/src/ycli/yandex/datalens/licensing/mcp.py b/src/ycli/yandex/datalens/licensing/mcp.py index 1833a3f12..d22df0f59 100644 --- a/src/ycli/yandex/datalens/licensing/mcp.py +++ b/src/ycli/yandex/datalens/licensing/mcp.py @@ -8,6 +8,7 @@ from ycli.settings import AppConfig from ycli.yandex.datalens.client import DataLensClient from ycli.yandex.datalens.dependencies import ( + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -64,7 +65,9 @@ def licenses_list( @mcp.tool( - name="licensing_licenses_assign", annotations={**WRITE, "title": "Assign DataLens licences"} + name="licensing_licenses_assign", + annotations={**WRITE, "title": "Assign DataLens licences"}, + meta=GRANTS_ACCESS, ) def licenses_assign( user_ids: Annotated[list[str], Field(description="The users to give a licence to.")], diff --git a/src/ycli/yandex/datalens/sharedentries/cli.py b/src/ycli/yandex/datalens/sharedentries/cli.py index 3f6873619..cba982157 100644 --- a/src/ycli/yandex/datalens/sharedentries/cli.py +++ b/src/ycli/yandex/datalens/sharedentries/cli.py @@ -49,6 +49,9 @@ def access_bindings_update( *, datalens: DataLensClient, ) -> Operation: - """Give or take away roles on a shared entry; the roles not named stay as they are.""" + """Give or take away roles on a shared entry; the roles not named stay as they are. + + Grants access: asks before it is sent (--yes to skip). + """ parsed = [AccessBindingDelta.model_validate_json(delta) for delta in deltas] return datalens.sharedentries.access_bindings_update(entry_id, deltas=parsed) diff --git a/src/ycli/yandex/datalens/sharedentries/endpoints.py b/src/ycli/yandex/datalens/sharedentries/endpoints.py index 31c3847f1..a0ccfd6e0 100644 --- a/src/ycli/yandex/datalens/sharedentries/endpoints.py +++ b/src/ycli/yandex/datalens/sharedentries/endpoints.py @@ -38,4 +38,10 @@ def access_bindings_update( entry_id: str, *, deltas: Sequence[AccessBindingDelta] ) -> Endpoint[Operation]: body = UpdateSharedEntryAccessBindingsArgs(entryId=entry_id, deltas=list(deltas)) - return RPC("updateSharedEntryAccessBindings", Operation, json=body, effect=Effect.WRITE) + return RPC( + "updateSharedEntryAccessBindings", + Operation, + json=body, + effect=Effect.WRITE, + grants_access=True, + ) diff --git a/src/ycli/yandex/datalens/sharedentries/mcp.py b/src/ycli/yandex/datalens/sharedentries/mcp.py index 4850597a3..9614f9722 100644 --- a/src/ycli/yandex/datalens/sharedentries/mcp.py +++ b/src/ycli/yandex/datalens/sharedentries/mcp.py @@ -8,6 +8,7 @@ from ycli.settings import AppConfig from ycli.yandex.datalens.client import DataLensClient from ycli.yandex.datalens.dependencies import ( + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -59,6 +60,7 @@ def access_bindings_list( @mcp.tool( name="sharedentries_access_bindings_update", annotations={**WRITE, "title": "Change the roles on a DataLens shared entry"}, + meta=GRANTS_ACCESS, ) def access_bindings_update( entry_id: SharedEntryID, diff --git a/src/ycli/yandex/datalens/workbooks/cli.py b/src/ycli/yandex/datalens/workbooks/cli.py index 86b11e8f8..85cb8d1a2 100644 --- a/src/ycli/yandex/datalens/workbooks/cli.py +++ b/src/ycli/yandex/datalens/workbooks/cli.py @@ -248,6 +248,9 @@ def delete_bulk(workbook_ids: WorkbookIDsArg, *, datalens: DataLensClient) -> Wo def access_bindings_update( workbook_id: WorkbookIDArg, deltas: DeltaOption, *, datalens: DataLensClient ) -> Operation: - """Give or take away roles on a workbook; the roles not named stay as they are.""" + """Give or take away roles on a workbook; the roles not named stay as they are. + + Grants access: asks before it is sent (--yes to skip). + """ parsed = [AccessBindingDelta.model_validate_json(delta) for delta in deltas] return datalens.workbooks.access_bindings_update(workbook_id, deltas=parsed) diff --git a/src/ycli/yandex/datalens/workbooks/endpoints.py b/src/ycli/yandex/datalens/workbooks/endpoints.py index 73df818a6..99ce4a0f3 100644 --- a/src/ycli/yandex/datalens/workbooks/endpoints.py +++ b/src/ycli/yandex/datalens/workbooks/endpoints.py @@ -161,4 +161,10 @@ def access_bindings_update( workbook_id: str, *, deltas: Sequence[AccessBindingDelta] ) -> Endpoint[Operation]: body = UpdateWorkbookAccessBindingsArgs(workbookId=workbook_id, deltas=list(deltas)) - return RPC("updateWorkbookAccessBindings", Operation, json=body, effect=Effect.WRITE) + return RPC( + "updateWorkbookAccessBindings", + Operation, + json=body, + effect=Effect.WRITE, + grants_access=True, + ) diff --git a/src/ycli/yandex/datalens/workbooks/mcp.py b/src/ycli/yandex/datalens/workbooks/mcp.py index 85f8ba701..239cd87c0 100644 --- a/src/ycli/yandex/datalens/workbooks/mcp.py +++ b/src/ycli/yandex/datalens/workbooks/mcp.py @@ -9,6 +9,7 @@ from ycli.yandex.datalens.client import DataLensClient from ycli.yandex.datalens.dependencies import ( DESTRUCTIVE, + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -256,6 +257,7 @@ def delete_bulk( @mcp.tool( name="workbooks_access_bindings_update", annotations={**WRITE, "title": "Change the roles on a DataLens workbook"}, + meta=GRANTS_ACCESS, ) def access_bindings_update( workbook_id: WorkbookID, diff --git a/src/ycli/yandex/errors.py b/src/ycli/yandex/errors.py index ea4eb4a14..fa1ae33a5 100644 --- a/src/ycli/yandex/errors.py +++ b/src/ycli/yandex/errors.py @@ -37,7 +37,7 @@ class YandexStaleContinuationError(YandexError): class YandexDeclinedError(YandexError): - """An operation that destroys data was not confirmed by the one asked; nothing was sent.""" + """An operation that destroys or grants was not confirmed by the one asked; nothing was sent.""" class YandexNotConfiguredError(YandexError): diff --git a/src/ycli/yandex/forms/access/cli.py b/src/ycli/yandex/forms/access/cli.py index ba817ebed..b7fe62df0 100644 --- a/src/ycli/yandex/forms/access/cli.py +++ b/src/ycli/yandex/forms/access/cli.py @@ -62,7 +62,10 @@ def update( *, forms: FormsClient, ) -> ItemList[Permission]: - """Set the access level of one action on form SURVEY_ID (POST …/access).""" + """Set the access level of one action on form SURVEY_ID (POST …/access). + + Grants access: asks before it is sent (--yes to skip). + """ body = AccessUpdate.model_validate({"action": action, "access": access}) return forms.access.update(survey_id, body) @@ -78,7 +81,10 @@ def grant( *, forms: FormsClient, ) -> ItemList[Permission]: - """Let a user (--uid / --cloud-uid) or a group (--group-src + --group-id) perform ACTION.""" + """Let a user (--uid / --cloud-uid) or a group (--group-src + --group-id) perform ACTION. + + Grants access: asks before it is sent (--yes to skip). + """ user, group = _principal(uid, cloud_uid, group_src, group_id) body = AccessGrant.model_validate({"action": action, "user": user, "group": group}) return forms.access.grant(survey_id, body) diff --git a/src/ycli/yandex/forms/access/endpoints.py b/src/ycli/yandex/forms/access/endpoints.py index 970caa9ac..ca7bd1712 100644 --- a/src/ycli/yandex/forms/access/endpoints.py +++ b/src/ycli/yandex/forms/access/endpoints.py @@ -33,6 +33,7 @@ def update(survey_id: str, body: AccessUpdate) -> Endpoint[ItemList[Permission]] ItemList[Permission], json=body, effect=Effect.IDEMPOTENT_WRITE, + grants_access=True, ) @@ -40,7 +41,12 @@ def grant(survey_id: str, body: AccessGrant) -> Endpoint[ItemList[Permission]]: path = f"{_access(survey_id)}/grant" # violation(arch-3): POST grants access: granting twice converges return Endpoint( - HTTPMethod.POST, path, ItemList[Permission], json=body, effect=Effect.IDEMPOTENT_WRITE + HTTPMethod.POST, + path, + ItemList[Permission], + json=body, + effect=Effect.IDEMPOTENT_WRITE, + grants_access=True, ) diff --git a/src/ycli/yandex/forms/access/mcp.py b/src/ycli/yandex/forms/access/mcp.py index 764d4a1b9..219d502b1 100644 --- a/src/ycli/yandex/forms/access/mcp.py +++ b/src/ycli/yandex/forms/access/mcp.py @@ -9,6 +9,7 @@ from ycli.yandex.forms.client import FormsClient from ycli.yandex.forms.dependencies import ( DESTRUCTIVE, + GRANTS_ACCESS, RO, WRITE_IDEMPOTENT, SurveyID, @@ -33,6 +34,7 @@ def list_(survey_id: SurveyID, client: FormsClient = Depends(forms_client)) -> I @mcp.tool( name="access_update", annotations={**WRITE_IDEMPOTENT, "title": "Set Forms survey access level"}, + meta=GRANTS_ACCESS, ) def update( survey_id: SurveyID, @@ -46,6 +48,7 @@ def update( @mcp.tool( name="access_grant", annotations={**WRITE_IDEMPOTENT, "title": "Grant Forms survey access"}, + meta=GRANTS_ACCESS, ) def grant( survey_id: SurveyID, diff --git a/src/ycli/yandex/forms/dependencies.py b/src/ycli/yandex/forms/dependencies.py index a6d67a6ec..ed10e5ae3 100644 --- a/src/ycli/yandex/forms/dependencies.py +++ b/src/ycli/yandex/forms/dependencies.py @@ -7,6 +7,7 @@ from ycli.yandex.forms.client import FormsClient from ycli.yandex.mcp import ( DESTRUCTIVE, + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -28,6 +29,7 @@ __all__ = [ "DESTRUCTIVE", + "GRANTS_ACCESS", "LIMIT_CAP", "RO", "TAGS", diff --git a/src/ycli/yandex/mcp.py b/src/ycli/yandex/mcp.py index 5269efd2b..fa4093a26 100644 --- a/src/ycli/yandex/mcp.py +++ b/src/ycli/yandex/mcp.py @@ -61,6 +61,13 @@ # hides tools behind a search step keeps it in sight. Claude Code reads this key # (https://code.claude.com/docs/en/mcp, "Exempt a server from deferral"); others pass it by. ALWAYS_LOAD: dict[str, bool] = {"anthropic/alwaysLoad": True} +# Meta of a tool whose operation grants access (``Endpoint.grants_access``): a client that +# honours it asks a person on every call, whatever mode it runs in, and denies the call where +# nobody can be asked. Claude Code reads this key (https://code.claude.com/docs/en/mcp, +# "Require approval for a specific tool", v2.1.214 or later); others pass it by, so the +# description of the tool says it in words (``ycli.mcp.listing.GrantsSaid``). +GRANTS_ACCESS: dict[str, bool] = {"anthropic/requiresUserInteraction": True} +GRANTS_ACCESS_SAID = "Grants access: a client that honours the mark asks a person on every call." # Meta keys of a prompt and of a resource template: the root-server tool names a prompt's # text tells the model to call, and the read tool a resource repeats. The server offers # neither when one of those tools is not served (ycli.mcp.listing.ServedWithTheirTools). diff --git a/src/ycli/yandex/tracker/dependencies.py b/src/ycli/yandex/tracker/dependencies.py index 420afe74d..acb0534c6 100644 --- a/src/ycli/yandex/tracker/dependencies.py +++ b/src/ycli/yandex/tracker/dependencies.py @@ -6,6 +6,7 @@ from ycli.yandex.mcp import ( DESTRUCTIVE, + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -64,6 +65,7 @@ __all__ = [ "DESTRUCTIVE", + "GRANTS_ACCESS", "LIMIT_CAP", "RO", "TAGS", diff --git a/src/ycli/yandex/tracker/entities/cli.py b/src/ycli/yandex/tracker/entities/cli.py index f27aef135..16de6e781 100644 --- a/src/ycli/yandex/tracker/entities/cli.py +++ b/src/ycli/yandex/tracker/entities/cli.py @@ -308,6 +308,9 @@ def permissions_update( The API accepts only ``grant`` / ``revoke`` actions, each mapping an access level (READ/WRITE/GRANT) to users/groups/roles, e.g. ``--acl 'grant={"READ":{"users":["8000000000000002"]}}'``. + + Grants access: asks before it is sent (--yes to skip). It asks even when the body only + takes rights away: the mark is of the operation. """ body = PermissionsUpdate.model_validate({"acl": parse_fields(field, structured=True)}) return tracker.entities.permissions_update(entity_type, entity_id, body=body) @@ -336,7 +339,11 @@ def permissions_update_direct( *, tracker: TrackerClient, ) -> ACL: - """Grant and revoke an entity's direct rights (PATCH …/permissions); pass --grant/--revoke.""" + """Grant and revoke an entity's direct rights (PATCH …/permissions); pass --grant/--revoke. + + Grants access: asks before it is sent (--yes to skip). It asks even when the body only + takes rights away: the mark is of the operation. + """ body = DirectPermissionsUpdate( grant=ACLInput.model_validate_json(grant) if grant is not None else None, revoke=ACLInput.model_validate_json(revoke) if revoke is not None else None, diff --git a/src/ycli/yandex/tracker/entities/endpoints.py b/src/ycli/yandex/tracker/entities/endpoints.py index f84c692f6..f303ea754 100644 --- a/src/ycli/yandex/tracker/entities/endpoints.py +++ b/src/ycli/yandex/tracker/entities/endpoints.py @@ -159,7 +159,7 @@ def permissions_update( entity_type: str, entity_id: str, body: PermissionsUpdate ) -> Endpoint[ExtendedPermissions]: path = f"{_entity(entity_type, entity_id)}/extendedPermissions" - return Endpoint(HTTPMethod.PATCH, path, ExtendedPermissions, json=body) + return Endpoint(HTTPMethod.PATCH, path, ExtendedPermissions, json=body, grants_access=True) def permissions_get_direct(entity_type: str, entity_id: str) -> Endpoint[ACL]: @@ -170,7 +170,11 @@ def permissions_update_direct( entity_type: str, entity_id: str, body: DirectPermissionsUpdate ) -> Endpoint[ACL]: return Endpoint( - HTTPMethod.PATCH, f"{_entity(entity_type, entity_id)}/permissions", ACL, json=body + HTTPMethod.PATCH, + f"{_entity(entity_type, entity_id)}/permissions", + ACL, + json=body, + grants_access=True, ) diff --git a/src/ycli/yandex/tracker/entities/mcp.py b/src/ycli/yandex/tracker/entities/mcp.py index 9530e155e..f47cbd8cf 100644 --- a/src/ycli/yandex/tracker/entities/mcp.py +++ b/src/ycli/yandex/tracker/entities/mcp.py @@ -17,6 +17,7 @@ from ycli.yandex.tracker.client import TrackerClient from ycli.yandex.tracker.dependencies import ( DESTRUCTIVE, + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -377,6 +378,7 @@ def delete( @mcp.tool( name="entities_permissions_update", annotations={**WRITE_IDEMPOTENT, "title": "Set Tracker entity permissions"}, + meta=GRANTS_ACCESS, ) def permissions_update( entity_type: EntityTypeName, @@ -397,6 +399,7 @@ def permissions_update( @mcp.tool( name="entities_permissions_update_direct", annotations={**WRITE_IDEMPOTENT, "title": "Set Tracker entity direct permissions"}, + meta=GRANTS_ACCESS, ) def permissions_update_direct( entity_type: EntityTypeName, diff --git a/src/ycli/yandex/tracker/queues/cli.py b/src/ycli/yandex/tracker/queues/cli.py index 9d51c5f15..82373fc9f 100644 --- a/src/ycli/yandex/tracker/queues/cli.py +++ b/src/ycli/yandex/tracker/queues/cli.py @@ -154,6 +154,9 @@ def permissions_update( A removal is not always the inverse of an addition: taking a user out of --read took it out of --write too (seen once, 2026-10-06). The command prints the permissions as they are after the change. + + Grants access: asks before it is sent (--yes to skip). It asks even when the body only + takes rights away: the mark is of the operation. """ body = QueuePermissionsUpdate( create=json.loads(create) if create is not None else None, diff --git a/src/ycli/yandex/tracker/queues/endpoints.py b/src/ycli/yandex/tracker/queues/endpoints.py index 2988d6650..ffd4214a3 100644 --- a/src/ycli/yandex/tracker/queues/endpoints.py +++ b/src/ycli/yandex/tracker/queues/endpoints.py @@ -76,7 +76,11 @@ def restore(queue_id: str) -> Endpoint[Queue]: def permissions_update(queue_id: str, body: QueuePermissionsUpdate) -> Endpoint[QueuePermissions]: return Endpoint( - HTTPMethod.PATCH, f"{_queue(queue_id)}/permissions", QueuePermissions, json=body + HTTPMethod.PATCH, + f"{_queue(queue_id)}/permissions", + QueuePermissions, + json=body, + grants_access=True, ) diff --git a/src/ycli/yandex/tracker/queues/mcp.py b/src/ycli/yandex/tracker/queues/mcp.py index 99db97e12..a2dfc11ea 100644 --- a/src/ycli/yandex/tracker/queues/mcp.py +++ b/src/ycli/yandex/tracker/queues/mcp.py @@ -10,6 +10,7 @@ from ycli.yandex.tracker.client import TrackerClient from ycli.yandex.tracker.dependencies import ( DESTRUCTIVE, + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -173,6 +174,7 @@ def restore(queue_id: QueueID, client: TrackerClient = Depends(tracker_client)) @mcp.tool( name="queues_permissions_update", annotations={**WRITE_IDEMPOTENT, "title": "Set Tracker queue permissions"}, + meta=GRANTS_ACCESS, ) def permissions_update( queue_id: QueueID, body: QueuePermissionsUpdate, client: TrackerClient = Depends(tracker_client) diff --git a/src/ycli/yandex/wiki/access/cli.py b/src/ycli/yandex/wiki/access/cli.py index baee735d2..a8b8d3dc8 100644 --- a/src/ycli/yandex/wiki/access/cli.py +++ b/src/ycli/yandex/wiki/access/cli.py @@ -76,6 +76,8 @@ def create( Name the user with --user-uid / --user-cloud-uid, or the group with --group-src and --group-id. + + Grants access: asks before it is sent (--yes to skip). """ user = ( UserIdentity(uid=user_uid, cloud_uid=user_cloud_uid) @@ -105,7 +107,10 @@ def update( *, wiki: WikiClient, ) -> PageAccess: - """Change the role or reach of an access (POST /pages/{id}/access/{access_id}).""" + """Change the role or reach of an access (POST /pages/{id}/access/{access_id}). + + Grants access: asks before it is sent (--yes to skip). + """ body = PageAccessUpdate(role=role, inheritance=inheritance) return wiki.access.update( page_id=page_id, diff --git a/src/ycli/yandex/wiki/access/endpoints.py b/src/ycli/yandex/wiki/access/endpoints.py index 2fe767190..7772bb9e8 100644 --- a/src/ycli/yandex/wiki/access/endpoints.py +++ b/src/ycli/yandex/wiki/access/endpoints.py @@ -21,7 +21,13 @@ def _selflock(prevent_selflock: bool | None) -> dict[str, bool | None]: def create(page_id: int, body: PageAccessCreate) -> Endpoint[PageAccess]: - return Endpoint(HTTPMethod.POST, f"pages/{segment(page_id)}/access", PageAccess, json=body) + return Endpoint( + HTTPMethod.POST, + f"pages/{segment(page_id)}/access", + PageAccess, + json=body, + grants_access=True, + ) def update( @@ -36,6 +42,7 @@ def update( params=_selflock(prevent_selflock), json=body, effect=Effect.IDEMPOTENT_WRITE, + grants_access=True, ) diff --git a/src/ycli/yandex/wiki/access/mcp.py b/src/ycli/yandex/wiki/access/mcp.py index b9746def2..7cfceedaa 100644 --- a/src/ycli/yandex/wiki/access/mcp.py +++ b/src/ycli/yandex/wiki/access/mcp.py @@ -10,6 +10,7 @@ from ycli.yandex.wiki.client import WikiClient from ycli.yandex.wiki.dependencies import ( DESTRUCTIVE, + GRANTS_ACCESS, WRITE, WRITE_IDEMPOTENT, new_server, @@ -26,7 +27,11 @@ ) -@mcp.tool(name="access_create", annotations={**WRITE, "title": "Grant Wiki page access"}) +@mcp.tool( + name="access_create", + annotations={**WRITE, "title": "Grant Wiki page access"}, + meta=GRANTS_ACCESS, +) def create( page_id: Annotated[int, _PAGE_ID], body: Annotated[ @@ -50,6 +55,7 @@ def create( @mcp.tool( name="access_update", annotations={**WRITE_IDEMPOTENT, "title": "Update Wiki page access"}, + meta=GRANTS_ACCESS, ) def update( page_id: Annotated[int, _PAGE_ID], diff --git a/src/ycli/yandex/wiki/dependencies.py b/src/ycli/yandex/wiki/dependencies.py index d07e6a223..8c444e663 100644 --- a/src/ycli/yandex/wiki/dependencies.py +++ b/src/ycli/yandex/wiki/dependencies.py @@ -6,6 +6,7 @@ from ycli.yandex.mcp import ( DESTRUCTIVE, + GRANTS_ACCESS, LIMIT_CAP, RO, WRITE, @@ -30,6 +31,7 @@ __all__ = [ "DESTRUCTIVE", + "GRANTS_ACCESS", "LIMIT_CAP", "RO", "TAGS", diff --git a/tests/contract/__init__.py b/tests/contract/__init__.py index dd57aedfc..f820f7e1c 100644 --- a/tests/contract/__init__.py +++ b/tests/contract/__init__.py @@ -32,6 +32,10 @@ from pathlib import Path from typing import TYPE_CHECKING, Any +import typer + +from ycli.cli.app import app +from ycli.cli.guard import GRANTS_ACCESS_HELP from ycli.yandex.core.endpoint import _EFFECT_BY_METHOD, ENDPOINT_EXTENSION from ycli.yandex.mcp import DESTRUCTIVE, RO, WRITE, WRITE_IDEMPOTENT from ycli.yandex.models import Listed @@ -341,6 +345,33 @@ def effect_sent(requests: Sequence[httpx2.Request]) -> Effect: return strongest(request.extensions[ENDPOINT_EXTENSION].effect for request in requests) +def grants_access(requests: Sequence[httpx2.Request]) -> bool: + """Whether an endpoint behind ``requests`` declared that it grants access.""" + return any(request.extensions[ENDPOINT_EXTENSION].grants_access for request in requests) + + +def help_of(argv: Sequence[str]) -> str: + """The help of the command ``argv`` runs, in one line.""" + command: Any = typer.main.get_command(app) + words = list(argv) + while hasattr(command, "get_command"): + # A word that names no command is a global option given first, or its value. + command = command.get_command(typer.Context(command), words.pop(0)) or command + return " ".join((command.help or "").split()) + + +def confirmed(case: Case) -> list[str]: + """``--yes`` where the command of ``case`` asks: a test has no terminal to answer on. + + It asks before it destroys data and before it grants access; the second it says in its + help, which ``test_cli_guard`` holds to the mark of its tool and the contract test to the + operation. + """ + assert case.cli is not None + asks = case.expected_effect == "destructive" or GRANTS_ACCESS_HELP in help_of(case.cli) + return ["--yes"] if asks else [] + + def hints_disagree(annotations: Mapping[str, Any], effect: Effect) -> list[str]: """The MCP hints in ``annotations`` that contradict ``effect`` (empty: they agree). diff --git a/tests/contract/test_contract.py b/tests/contract/test_contract.py index 986ebcf52..d9347d755 100644 --- a/tests/contract/test_contract.py +++ b/tests/contract/test_contract.py @@ -27,7 +27,9 @@ Reply, Sent, Sibling, + confirmed, effect_sent, + grants_access, hints_disagree, load_cases, mismatches, @@ -42,11 +44,14 @@ from ycli.yandex.core.auth import IAMTokenAuth from ycli.yandex.core.listing import Listing from ycli.yandex.core.resource import Resource +from ycli.yandex.mcp import GRANTS_ACCESS, GRANTS_ACCESS_SAID from ycli.yandex.registry import SERVICES if TYPE_CHECKING: from collections.abc import Iterator, Mapping, Sequence + from fastmcp.tools import Tool + from ycli.yandex.base import DomainClient from ycli.yandex.service import Service @@ -121,11 +126,15 @@ def _run_sdk(case: Case) -> object: ) +def _marked(tool: Tool) -> bool: + """Whether ``tool`` carries the mark of an operation that grants access.""" + return all((tool.meta or {}).get(key) is value for key, value in GRANTS_ACCESS.items()) + + def _run_cli(case: Case, argv: Sequence[str] | None = None) -> object: assert case.cli is not None - # A test has no terminal to answer the prompt a destructive operation raises. - confirmed = ["--yes"] if case.expected_effect == "destructive" else [] - result = CliRunner().invoke(app, ["--format", "json", *confirmed, *(argv or case.cli)]) + # A test has no terminal to answer the prompt of an operation that destroys or grants. + result = CliRunner().invoke(app, ["--format", "json", *confirmed(case), *(argv or case.cli)]) assert result.exit_code == 0, result.output try: return json.loads(result.stdout_bytes) @@ -174,6 +183,7 @@ def test_every_surface_sends_the_declared_requests(case: Case, monkeypatch, mcp_ api = _serve(monkeypatch, case) sdk_output = _run_sdk(case) _check_sent(case, api, "sdk") + grants = grants_access(api.calls) problems = output_problems(case, sdk_output) assert not problems, f"sdk result: {problems}" cli_output = None @@ -197,6 +207,11 @@ def test_every_surface_sends_the_declared_requests(case: Case, monkeypatch, mcp_ hints = tool.annotations.model_dump(by_alias=True) if tool.annotations else {} wrong = hints_disagree(hints, case.expected_effect) assert not wrong, f"{case.mcp[0]}: effect {case.expected_effect!r} but {wrong} disagree" + # ARCH-3, both ways: the mark is on the tool if and only if its operation grants access. + assert _marked(tool) == grants, ( + f"{name}: the mark is {_marked(tool)}, the operation {grants}" + ) + assert (GRANTS_ACCESS_SAID in (tool.description or "")) == grants, f"{name}: description" if case.cli is not None: assert cli_output == mcp_output, "the CLI and MCP return different data" @@ -236,8 +251,7 @@ def test_an_empty_reply_is_answered_the_same_by_the_cli_and_mcp( for name, value in case.env.items(): monkeypatch.setenv(name, value) _serve(monkeypatch, emptied) - confirmed = ["--yes"] if case.expected_effect == "destructive" else [] - printed = CliRunner().invoke(app, ["--format", "json", *confirmed, *emptied.cli]) + printed = CliRunner().invoke(app, ["--format", "json", *confirmed(case), *emptied.cli]) cli_answer = json.loads(printed.stdout_bytes) if printed.exit_code == 0 else REFUSED _serve(monkeypatch, emptied) try: diff --git a/tests/contract/test_output_formats.py b/tests/contract/test_output_formats.py index a98c145e9..dc1e48e9a 100644 --- a/tests/contract/test_output_formats.py +++ b/tests/contract/test_output_formats.py @@ -17,6 +17,7 @@ from pydantic import BaseModel, RootModel from typer.testing import CliRunner +from tests.contract import confirmed from tests.contract.test_contract import CASES, _serve from ycli.cli.app import app from ycli.cli.inject import NO_NAME @@ -39,8 +40,7 @@ def _printed(case: Case, output_format: str, monkeypatch: pytest.MonkeyPatch) -> for name, value in case.env.items(): monkeypatch.setenv(name, value) _serve(monkeypatch, case) - confirmed = ["--yes"] if case.expected_effect == "destructive" else [] - result = CliRunner().invoke(app, ["--format", output_format, *confirmed, *case.cli]) + result = CliRunner().invoke(app, ["--format", output_format, *confirmed(case), *case.cli]) assert result.exit_code == 0, result.output return result.stdout_bytes @@ -174,8 +174,7 @@ def _named(case: Case, monkeypatch: pytest.MonkeyPatch) -> tuple[Any, Any]: for name, value in case.env.items(): monkeypatch.setenv(name, value) api = _serve(monkeypatch, case) - confirmed = ["--yes"] if case.expected_effect == "destructive" else [] - return CliRunner().invoke(app, ["--format", "name", *confirmed, *case.cli]), api + return CliRunner().invoke(app, ["--format", "name", *confirmed(case), *case.cli]), api def test_every_sparse_operation_has_a_case_that_leaves_an_item_unnamed(monkeypatch): diff --git a/tests/unit/cli/test_cli_guard.py b/tests/unit/cli/test_cli_guard.py index 9e134a79c..ec2f29f14 100644 --- a/tests/unit/cli/test_cli_guard.py +++ b/tests/unit/cli/test_cli_guard.py @@ -1,12 +1,16 @@ """The CLI's gate on destructive operations: asks first, ``--yes`` skips, no terminal refuses.""" +import asyncio from http import HTTPMethod import httpx2 import pytest import typer +from fastmcp import Client from typer.testing import CliRunner +from tests import full_server +from tests.contract import help_of, load_cases from tests.hosts import TRACKER_BASE from ycli.cli import guard from ycli.cli.app import app @@ -155,3 +159,81 @@ def test_a_command_with_its_own_yes_keeps_its_meaning(api, monkeypatch): monkeypatch.setattr(status_cli, "OAuthAppConfig", lambda: type("C", (), {"client_id": ""})()) result = runner.invoke(app, ["auth", "login", "--yes"]) assert "No OAuth app configured" in result.output # it parsed `--yes` and ran + + +def _check_grant(options: dict) -> None: + """The same, for a write that grants access and destroys nothing.""" + grant = Endpoint(HTTPMethod.POST, "items/7", effect=Effect.WRITE, grants_access=True) + guard_of(options).check(grant, httpx2.Request("POST", "https://api.test/v1/items/7")) + + +def test_a_grant_asks_in_words_of_its_own(asked, monkeypatch, capsys): + _attended(monkeypatch, True) + _check_grant({}) + assert asked == ["POST https://api.test/v1/items/7 — this grants access. Continue?"] + _check_grant({"yes": True}) + assert len(asked) == 1 # --yes asks nothing + _attended(monkeypatch, False) + with pytest.raises(typer.Exit) as stopped: + _check_grant({}) + assert stopped.value.exit_code == ExitCode.USAGE + said = capsys.readouterr().err + assert "this grants access. Pass --yes to confirm; there is no terminal" in said + + +def test_without_a_terminal_a_delete_and_a_grant_say_which_they_are(monkeypatch, capsys): + _attended(monkeypatch, False) + with pytest.raises(typer.Exit): + _check({}) + assert "this deletes data. Pass --yes" in capsys.readouterr().err + + +GRANT_ACCESS = ["wiki", "access", "create", "7", "--role", "editor", "--user-uid", "9001"] + + +def test_a_command_that_grants_access_asks_and_a_dry_run_of_it_does_not(api, asked, monkeypatch): + """Through the real entry point: the prompt, `--yes`, and `--dry-run`, which asks nobody.""" + api.add( + "POST", "https://api.wiki.yandex.net/v1/pages/7/access", json={"id": "a1", "role": "editor"} + ) + _attended(monkeypatch, True) + planned = runner.invoke(app, ["-o", "json", *GRANT_ACCESS, "--dry-run"]) + assert planned.exit_code == 0, planned.output + assert asked == [] and api.calls == [] + sent = runner.invoke(app, ["-o", "json", *GRANT_ACCESS]) + assert sent.exit_code == 0, sent.output + assert len(asked) == 1 and asked[0].endswith("/pages/7/access — this grants access. Continue?") + runner.invoke(app, ["-o", "json", *GRANT_ACCESS, "--yes"]) + assert len(asked) == 1 and len(api.calls) == 2 + _attended(monkeypatch, False) + refused = runner.invoke(app, GRANT_ACCESS) + assert refused.exit_code == ExitCode.USAGE and len(api.calls) == 2 + assert "this grants access. Pass --yes" in refused.stderr + + +def test_the_help_of_a_command_says_it_grants_access_where_its_tool_is_marked(): + """One fact, on both surfaces: the contract test holds the tool's mark to the operation. + + The count is pinned on purpose: a mark and its meta taken off together agree with each + other and with the help, and only the number says that an operation stopped asking. + """ + + async def marked() -> set[str]: + async with Client(full_server.mcp) as client: + return { + tool.name + for tool in await client.list_tools() + if (tool.meta or {}).get("anthropic/requiresUserInteraction") is True + } + + marks = asyncio.run(marked()) + said, wrong = set(), [] + for case in load_cases(): + if case.cli is None or case.mcp is None: + continue + says = guard.GRANTS_ACCESS_HELP in help_of(case.cli) + said |= {case.mcp[0]} if says else set() + if says != (case.mcp[0] in marks): + wrong.append(case.id) + assert not wrong + assert said == marks and len(marks) == 14 diff --git a/tests/unit/mcp/test_mcp_listing.py b/tests/unit/mcp/test_mcp_listing.py index fddfb2cf0..16e96412e 100644 --- a/tests/unit/mcp/test_mcp_listing.py +++ b/tests/unit/mcp/test_mcp_listing.py @@ -10,8 +10,15 @@ from tests.full_server import mcp from tests.hosts import TRACKER_BASE -from ycli.mcp.listing import DerivedTags, strip_examples -from ycli.yandex.mcp import DESTRUCTIVE, RO, WRITE, WRITE_TAG +from ycli.mcp.listing import DerivedTags, GrantsSaid, strip_examples +from ycli.yandex.mcp import ( + DESTRUCTIVE, + GRANTS_ACCESS, + GRANTS_ACCESS_SAID, + RO, + WRITE, + WRITE_TAG, +) from ycli.yandex.tracker.mcp.server import mcp as tracker_mcp @@ -110,3 +117,27 @@ async def nothing(name: str, *, version: VersionSpec | None = None) -> Tool | No return None assert await DerivedTags().get_tool("tracker_ghost", nothing) is None + + +async def test_a_tool_that_grants_access_says_so_in_words_once(): + """The mark is a key one client reads: the description says it for the others.""" + + def grant() -> str: + """Give a user a role.""" + return "" + + marked = Tool.from_function(grant, name="wiki_access_create", meta=GRANTS_ACCESS) + plain = Tool.from_function(grant, name="wiki_access_list") + said, untouched = await GrantsSaid().list_tools([marked, plain]) + assert said.description == f"Give a user a role.\n\n{GRANTS_ACCESS_SAID}" + assert untouched is plain + # A server mounted in another passes its tools through the transform twice. + [again] = await GrantsSaid().list_tools([said]) + assert again is said + + async def held(name: str, *, version: VersionSpec | None = None) -> Tool | None: + return marked if name == marked.name else None + + found = await GrantsSaid().get_tool(marked.name, held) + assert found is not None and found.description == said.description + assert await GrantsSaid().get_tool("wiki_ghost", held) is None diff --git a/tests/unit/mcp/test_mcp_selection.py b/tests/unit/mcp/test_mcp_selection.py index 347b12256..b2cb960cb 100644 --- a/tests/unit/mcp/test_mcp_selection.py +++ b/tests/unit/mcp/test_mcp_selection.py @@ -12,8 +12,8 @@ from ycli.mcp.listing import UnknownToolError from ycli.mcp.profiles import ALWAYS_SERVED, CORE_TOOLS, SCHEMA_TOOL, STATUS_TOOL from ycli.mcp.selection import CORE, Selection, split_names -from ycli.mcp.server import build_server, check_tool_names -from ycli.yandex.mcp import WRITE_TAG +from ycli.mcp.server import BY_ITS_OWN_NAME, build_server, check_tool_names +from ycli.yandex.mcp import GRANTS_ACCESS, WRITE_TAG async def served(selection: Selection) -> set[str]: @@ -228,7 +228,9 @@ async def test_a_name_from_an_unselected_service_is_checked_not_rejected(): async def test_tool_search_lists_a_search_interface_and_status(): server = build_server(Selection(tool_search=True)) async with Client(server) as client: - names = {tool.name for tool in await client.list_tools()} + tools = await client.list_tools() + # What grants access stays listed by its own name (see the test of it below). + names = {tool.name for tool in tools if not _grants(tool)} assert names == {"search_tools", "call_tool", *ALWAYS_SERVED} found = await client.call_tool("search_tools", {"query": "tracker issue comments add"}) assert "tracker_comments_create" in { @@ -266,3 +268,49 @@ async def test_the_always_served_tools_stay_in_sight_of_a_client_that_searches_i marks = {tool.name: (tool.meta or {}).get("anthropic/alwaysLoad") for tool in listed} assert {name for name, mark in marks.items() if mark is not None} == {*ALWAYS_SERVED} assert all(marks[name] is True for name in ALWAYS_SERVED) + + +def _grants(tool) -> bool: + return all((tool.meta or {}).get(key) is value for key, value in GRANTS_ACCESS.items()) + + +async def test_a_tool_that_grants_access_stays_listed_under_tool_search_with_its_mark(api): + """A client reads the mark from the tool's own entry: behind a proxy nobody would be asked. + + So under `--tool-search` the marked tools stay in the listing, each with its mark, and the + proxy refuses to run one: it is called by its own name, where the client can ask a person. + """ + async with Client(full_server) as client: + marked = {tool.name for tool in await client.list_tools() if _grants(tool)} + assert len(marked) == 14 + server = build_server(Selection(tool_search=True)) + async with Client(server) as client: + listed = {tool.name: tool for tool in await client.list_tools()} + assert set(listed) == {"search_tools", "call_tool", *ALWAYS_SERVED, *marked} + assert all(_grants(listed[name]) for name in marked) + assert not _grants(listed["call_tool"]) and not _grants(listed["search_tools"]) + for name in sorted(marked): + refused = await client.call_tool( + "call_tool", {"name": name, "arguments": {}}, raise_on_error=False + ) + assert refused.is_error and BY_ITS_OWN_NAME in refused.content[0].text, name + assert api.calls == [] + # The search does not offer what the proxy will not run. + found = await client.call_tool("search_tools", {"query": "grant access to a wiki page"}) + assert not marked & {item["name"] for item in found.structured_content["result"]} + # A write that grants nothing still goes through the proxy. + api.add("POST", f"{TRACKER_BASE}/issues/QA-1/comments/", json={"id": 1}) + sent = await client.call_tool( + "call_tool", + { + "name": "tracker_comments_create", + "arguments": {"issue_key": "QA-1", "body": {"text": "hi"}}, + }, + ) + assert not sent.is_error and [call.method for call in api.calls] == ["POST"] + + +async def test_a_marked_tool_is_not_served_read_only_under_tool_search_either(): + server = build_server(Selection(read_only=True, tool_search=True)) + async with Client(server) as client: + assert not [tool.name for tool in await client.list_tools() if _grants(tool)] diff --git a/tests/unit/yandex/core/test_guard.py b/tests/unit/yandex/core/test_guard.py index d52367e55..840f3f2ca 100644 --- a/tests/unit/yandex/core/test_guard.py +++ b/tests/unit/yandex/core/test_guard.py @@ -115,3 +115,33 @@ async def run() -> list[str]: return [call.method for call in api.calls] assert asyncio.run(run()) == ["GET"] + + +#: A write that lets someone at data: asked about like a delete, though it destroys nothing. +GRANT = Endpoint(HTTPMethod.PATCH, "items/1", json={"role": "admin"}, grants_access=True) + + +def test_what_grants_access_is_confirmed_and_the_one_asked_is_told_which_it_is(): + api = _api() + asked: list[PlannedRequest] = [] + session = _session(api, Guard(confirm=lambda plan: asked.append(plan) or True)) + for operation in (PATCH, GRANT, DELETE): + session.send(operation) + assert [(plan.method, plan.grants_access) for plan in asked] == [ + ("PATCH", True), + ("DELETE", False), + ] + # Why it is asked is for the one who asks: the plan a person is shown does not grow. + assert "grants_access" not in asked[0].model_dump() | asked[0].model_dump(by_alias=True) + assert "grants_access" not in type(asked[0]).model_fields + + +def test_a_grant_that_is_not_confirmed_is_not_sent_and_a_dry_run_asks_nobody(): + api = _api() + with pytest.raises(YandexDeclinedError, match="was not confirmed; nothing was sent"): + _session(api, Guard(confirm=lambda plan: False)).send(GRANT) + with pytest.raises(RequestPlanned) as planned: + _session(api, Guard(dry_run=True, confirm=lambda plan: pytest.fail("asked"))).send(GRANT) + assert planned.value.plan.body == {"role": "admin"} and api.calls == [] + _session(api, Guard()).send(GRANT) # nobody to ask: it is sent, as the SDK does + assert [call.method for call in api.calls] == ["PATCH"] diff --git a/tests/unit/yandex/tracker/entities/test_cli.py b/tests/unit/yandex/tracker/entities/test_cli.py index ad45db5e2..5ccbf4aa4 100644 --- a/tests/unit/yandex/tracker/entities/test_cli.py +++ b/tests/unit/yandex/tracker/entities/test_cli.py @@ -33,7 +33,7 @@ def test_order_asc_without_order_by_is_sent_as_given(api): def test_set_direct_permissions_with_nothing_to_change_sends_an_empty_body(api): api.add("PATCH", f"{BASE}/entities/project/655f/permissions", json={}) res = CliRunner().invoke( - cli.app, ["tracker", "entities", "permissions-update-direct", "project", "655f"] + cli.app, ["--yes", "tracker", "entities", "permissions-update-direct", "project", "655f"] ) assert res.exit_code == 0 assert api.body() == {} diff --git a/tests/unit/yandex/wiki/test_cli.py b/tests/unit/yandex/wiki/test_cli.py index ce054cff0..ce93170ea 100644 --- a/tests/unit/yandex/wiki/test_cli.py +++ b/tests/unit/yandex/wiki/test_cli.py @@ -50,7 +50,9 @@ def test_a_group_grant_needs_both_its_directory_and_its_id(api): def test_a_grant_naming_no_one_is_sent_as_given(api): api.add("POST", f"{BASE}/pages/1/access", json={"id": "5", "role": "reader"}) - res = CliRunner().invoke(cli.app, ["wiki", "access", "create", "1", "--role", "reader"]) + res = CliRunner().invoke( + cli.app, ["--yes", "wiki", "access", "create", "1", "--role", "reader"] + ) assert res.exit_code == 0, res.output assert api.body() == {"role": "reader"}