diff --git a/.agents/skills/yandex-360/SKILL.md b/.agents/skills/yandex-360/SKILL.md index f946b606..52b153d6 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 dbd74d9a..c89fbc46 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 dbd74d9a..c89fbc46 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 4298acf5..abb1c5f1 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 338e1a79..f225b168 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 10244064..64aef6ae 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 404bcefd..4703a084 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 07bcb2cd..b4c9a4d7 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 3f63d8b6..3e9933c9 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 14d8baa4..e7218bb4 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 ceeff3aa..6597baf8 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 72496105..8ac83c65 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 04364a96..c4ba6cd5 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 2f58f089..ee59306b 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 61302918..7a5d0a79 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 44a26799..b5711f47 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 4f9ed99f..0535d3a1 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 78cc5001..b7834088 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 213563be..e816abdc 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 d277e252..59fd0202 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 c82de6fc..ed1eecb6 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 9dbae0c4..db69bac2 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 9af31242..608ba177 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 bdac10fb..cc86b443 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 5d18f011..70249696 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 2a330244..2a477009 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 1b0f7607..e112a4b0 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 44dda3ad..b3b01dfb 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 b50b2fdb..bf3672a3 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 e1c93ccd..960f73fe 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 bb03c7a9..f283a1c6 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 128b529b..21719abc 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 66dd6f7f..941a73f0 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 9edf29f7..73be977f 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 1f478342..d303f46b 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 51f61e9b..dec33b1a 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 4667a35c..dbc18c7c 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 05e8bc8e..2cdf0d4d 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 5aad0d12..85c41562 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 94e1f274..954f0601 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 1833a3f1..d22df0f5 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 3f687361..cba98215 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 31c3847f..a0ccfd6e 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 4850597a..9614f972 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 86b11e8f..85cb8d1a 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 73df818a..99ce4a0f 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 85f8ba70..239cd87c 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 ea4eb4a1..fa1ae33a 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 ba817ebe..b7fe62df 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 970caa9a..ca7bd171 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 764d4a1b..219d502b 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 a6d67a6e..ed10e5ae 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 5269efd2..fa4093a2 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 420afe74..acb0534c 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 f27aef13..16de6e78 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 f84c692f..f303ea75 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 9530e155..f47cbd8c 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 9d51c5f1..82373fc9 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 2988d665..ffd4214a 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 99db97e1..a2dfc11e 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 baee735d..a8b8d3dc 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 2fe76719..7772bb9e 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 b9746def..7cfceeda 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 d07e6a22..8c444e66 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 dd57aedf..f820f7e1 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 986ebcf5..d9347d75 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 a98c145e..dc1e48e9 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 9e134a79..ec2f29f1 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 fddfb2cf..16e96412 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 347b1225..b2cb960c 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 d52367e5..840f3f2c 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 ad45db5e..5ccbf4aa 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 ce054cff..ce93170e 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"}