Skip to content

ycli tracker

Yandex Tracker: issues, queues, boards, sprints, fields, automation.

Usage:

$ ycli tracker [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • auth: Check that the token works for tracker.
  • me: Tracker authenticated user.
  • issues: Tracker issues.
  • comments: Tracker issue comments.
  • links: Tracker issue links.
  • transitions: Tracker issue transitions.
  • worklog: Tracker issue worklog.
  • changelog: Tracker issue changelog.
  • checklists: Tracker issue checklists.
  • columns: Tracker agile board columns.
  • priorities: Tracker priorities.
  • issuetypes: Tracker issue types.
  • linktypes: Tracker link types.
  • users: Tracker organisation users.
  • statuses: Tracker issue statuses.
  • resolutions: Tracker issue resolutions.
  • queues: Tracker queues.
  • localfields: Tracker per-queue local fields.
  • fields: Tracker global fields.
  • components: Tracker components.
  • filters: Tracker saved filters.
  • applications: Tracker external applications.
  • boards: Tracker agile boards.
  • sprints: Tracker board sprints.
  • attachments: Tracker issue attachments.
  • macros: Tracker queue macros.
  • triggers: Tracker queue triggers.
  • autoactions: Tracker queue autoactions.
  • bulk: Tracker async bulk changes.
  • remotelinks: Tracker issue external-app links.
  • dashboards: Tracker dashboards.
  • entities: Tracker projects, portfolios and goals.
  • workflows: Tracker workflows.
  • projects: Tracker projects (legacy API).
  • gaps: Tracker employee absences (admin).

ycli tracker auth

Check that the token works for tracker.

Usage:

$ ycli tracker auth [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • status: Probe tracker with its own read; exit 1...

ycli tracker auth status

Probe tracker with its own read; exit 1 when the token is rejected.

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker me

Tracker authenticated user.

Usage:

$ ycli tracker me [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • get: Print the authenticated user (a safe auth...

ycli tracker me get

Print the authenticated user (a safe auth probe).

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issues

Tracker issues.

Usage:

$ ycli tracker issues [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • get: Print a single issue (full model) for...
  • list: List issues matching the supplied filters...
  • search: Search issues by a TQL query string...
  • count: Count issues matching a TQL query or...
  • create: Create an issue (POST /issues/).
  • update: Update issue ISSUE_KEY (PATCH...
  • move: Move issue ISSUE_KEY to another QUEUE...
  • suggest: Suggest issues whose summary contains...
  • scroll-clear: Release the scroll of a search before it...
  • update-bulk: Mass-edit issues (POST /bulkchange/_update).
  • move-bulk: Mass-move issues to another QUEUE (POST...
  • transition-bulk: Mass status transition (POST...
  • import: Import an issue preserving its history...

ycli tracker issues get

Print a single issue (full model) for ISSUE_KEY.

Usage:

$ ycli tracker issues get [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issues list

List issues matching the supplied filters (auto-paginated; --all for everything).

Usage:

$ ycli tracker issues list [OPTIONS]

Options:

  • --queue TEXT: Queue key.
  • --status TEXT: Status key.
  • --assignee TEXT: Assignee login.
  • --epic TEXT: Epic key.
  • --issue-type TEXT: Issue type key.
  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Search issues by a TQL query string (auto-paginated; --all for everything).

A token of a scroll (--scroll-type) works once: used again, it gives the portion after.

Usage:

$ ycli tracker issues search [OPTIONS] QUERY

Arguments:

  • QUERY: TQL query. [required]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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.
  • --expand TEXT: Extra blocks to include in the reply.
  • --scroll-type TEXT: Scroll through the results (no 10 000 cap). Known values: sorted, unsorted.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issues count

Count issues matching a TQL query or filters (bare integer).

With no --query and no filters this sends an empty filter — the API then counts EVERY issue in the org. Pass --queue/--status (or --query) to narrow.

Usage:

$ ycli tracker issues count [OPTIONS]

Options:

  • --query TEXT: TQL query (mutually exclusive with filters).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issues create

Create an issue (POST /issues/). type/priority wrap to {"key": …}; queue/parent stay bare.

Usage:

$ ycli tracker issues create [OPTIONS]

Options:

  • --queue TEXT: Target queue key. [required]
  • --summary TEXT: Issue summary (title). [required]
  • --type TEXT: Issue type key, e.g. task.
  • --priority TEXT: Priority key, e.g. normal.
  • --parent TEXT: Parent issue key.
  • --description TEXT: Markdown body — pass "$(cat file.md)".
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issues update

Update issue ISSUE_KEY (PATCH /issues/{key}) — only supplied fields are sent.

Usage:

$ ycli tracker issues update [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --summary TEXT: New summary.
  • --type TEXT: New issue type key.
  • --priority TEXT: New priority key.
  • --parent TEXT: New parent 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issues move

Move issue ISSUE_KEY to another QUEUE (POST /issues/{key}/_move?queue=QUEUE).

Usage:

$ ycli tracker issues move [OPTIONS] ISSUE_KEY QUEUE

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • QUEUE: Target queue key, e.g. NEW. [required]

Options:

  • --expand TEXT: Extra blocks to include in the reply.
  • --initial-status / --no-initial-status: Reset the status to the new queue's initial one.
  • --move-all-fields / --no-move-all-fields: Keep the versions, components and projects the new queue also has.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issues suggest

Suggest issues whose summary contains INPUT (GET /issues/_suggest?input=INPUT).

Usage:

$ ycli tracker issues suggest [OPTIONS] INPUT

Arguments:

  • INPUT: Text fragment to match in titles. [required]

Options:

  • --queue TEXT: Key of the queue to search in.
  • --full / --no-full: Return each issue in full; needed for --fields, --expand, --embed.
  • --fields TEXT: Comma-separated fields to include in the reply.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issues scroll-clear

Release the scroll of a search before it expires (POST /system/search/scroll/_clear).

Only issues search --scroll-type has something to release; after this its token goes on nowhere.

Usage:

$ ycli tracker issues scroll-clear [OPTIONS]

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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issues update-bulk

Mass-edit issues (POST /bulkchange/_update). Set fields with repeated -F key=value.

Usage:

$ ycli tracker issues update-bulk [OPTIONS]

Options:

  • --issue TEXT: Issue key to include (repeatable; omit when using --query).
  • --query TEXT: Query-language filter selecting issues (instead of --issue).
  • -F, --field TEXT: Field to set, 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.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: 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.
  • --help: Show this message and exit.

ycli tracker issues move-bulk

Mass-move issues to another QUEUE (POST /bulkchange/_move).

Usage:

$ ycli tracker issues move-bulk [OPTIONS] QUEUE

Arguments:

  • QUEUE: Target queue key, e.g. CHECK. [required]

Options:

  • --issue TEXT: Issue key to include (repeatable; omit when using --query).
  • --query TEXT: Query-language filter selecting issues (instead of --issue).
  • -F, --field TEXT: Field to set, 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.
  • --move-all-fields / --no-move-all-fields: Carry versions/components/projects across.
  • --initial-status / --no-initial-status: Reset each issue's status to the initial one.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: 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.
  • --help: Show this message and exit.

ycli tracker issues transition-bulk

Mass status transition (POST /bulkchange/_transition). -F resolution=fixed for close.

Usage:

$ ycli tracker issues transition-bulk [OPTIONS] TRANSITION

Arguments:

  • TRANSITION: Transition id, e.g. close. [required]

Options:

  • --issue TEXT: Issue key to include (repeatable; omit when using --query).
  • --query TEXT: Query-language filter selecting issues (instead of --issue).
  • -F, --field TEXT: Field to set, 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.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: 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.
  • --help: Show this message and exit.

ycli tracker issues import

Import an issue preserving its history (POST /issues/_import).

Usage:

$ ycli tracker issues import [OPTIONS]

Options:

  • --queue TEXT: Target queue key. [required]
  • --summary TEXT: Issue title. [required]
  • --created-at TEXT: Original creation time, YYYY-MM-DDThh🇲🇲ss.sss±hhmm. [required]
  • --created-by TEXT: Login or id of the original author. [required]
  • --key TEXT: Explicit issue key (must belong to the queue).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker comments

Tracker issue comments.

Usage:

$ ycli tracker comments [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all comments on issue ISSUE_KEY...
  • get: Print comment COMMENT_ID of issue ISSUE_KEY.
  • create: Add a comment to issue ISSUE_KEY.
  • update: Edit comment COMMENT_ID on issue ISSUE_KEY.
  • delete: Delete comment COMMENT_ID from issue...
  • reactions-create: Add reaction NAME to comment COMMENT_ID on...
  • import: Import a comment onto issue ISSUE_KEY...

ycli tracker comments list

List all comments on issue ISSUE_KEY (auto-paginated; --all for everything).

Usage:

$ ycli tracker comments list [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker comments get

Print comment COMMENT_ID of issue ISSUE_KEY.

Usage:

$ ycli tracker comments get [OPTIONS] ISSUE_KEY COMMENT_ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • COMMENT_ID: Comment id (numeric id or longId). [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker comments create

Add a comment to issue ISSUE_KEY.

Usage:

$ ycli tracker comments create [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker comments update

Edit comment COMMENT_ID on issue ISSUE_KEY.

Usage:

$ ycli tracker comments update [OPTIONS] ISSUE_KEY COMMENT_ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • COMMENT_ID: Comment id (numeric id or longId). [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker comments delete

Delete comment COMMENT_ID from issue ISSUE_KEY.

Usage:

$ ycli tracker comments delete [OPTIONS] ISSUE_KEY COMMENT_ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • COMMENT_ID: Comment id (numeric id or longId). [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker comments reactions-create

Add reaction NAME to comment COMMENT_ID on issue ISSUE_KEY.

Usage:

$ ycli tracker comments reactions-create [OPTIONS] ISSUE_KEY COMMENT_ID NAME

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • COMMENT_ID: Comment id (numeric id or longId). [required]
  • NAME: Reaction name. Known values: LIKE, DISLIKE, LAUGH, HOORAY, CONFUSED, HEART, ROCKET, EYES, FIRE, OK, FACEPALM, CHECK. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker comments import

Import a comment onto issue ISSUE_KEY (POST /issues/{issue_key}/comments/_import).

Usage:

$ ycli tracker comments import [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --text TEXT: Comment text. [required]
  • --created-at TEXT: Original creation time, YYYY-MM-DDThh🇲🇲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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Tracker issue links.

Usage:

$ ycli tracker links [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List links for issue ISSUE_KEY.
  • list-filtered: List links of ISSUE_KEY, filtered and...
  • create: Link issue ISSUE_KEY to TARGET with...
  • delete: Delete link LINK_ID from issue ISSUE_KEY.
  • import: Import a link on issue ISSUE_KEY (POST...

List links for issue ISSUE_KEY.

Usage:

$ ycli tracker links list [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

List links of ISSUE_KEY, filtered and paged (POST …/links/_list; --all for everything).

Usage:

$ ycli tracker links list-filtered [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --link-types TEXT: Keep only links with this relationship, e.g. relates (repeatable).
  • --fields TEXT: Field to include in each link (repeatable).
  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Link issue ISSUE_KEY to TARGET with RELATIONSHIP.

Usage:

$ ycli tracker links create [OPTIONS] ISSUE_KEY RELATIONSHIP TARGET

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • RELATIONSHIP: Relationship verb. Known values: depends on, is dependent by, relates, duplicates, is duplicated by, subtask, parent. [required]
  • TARGET: Target issue key, e.g. DATAENGINEERING-2. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Delete link LINK_ID from issue ISSUE_KEY.

Usage:

$ ycli tracker links delete [OPTIONS] ISSUE_KEY LINK_ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • LINK_ID: Link id to remove. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Import a link on issue ISSUE_KEY (POST /issues/{issue_key}/links/_import).

Usage:

$ ycli tracker links import [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --relationship TEXT: Link type, e.g. relates. [required]
  • --issue TEXT: Key or id of the issue to link to. [required]
  • --created-at TEXT: Original creation time, YYYY-MM-DDThh🇲🇲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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker transitions

Tracker issue transitions.

Usage:

$ ycli tracker transitions [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List available transitions for issue...
  • execute: Execute transition ID on issue ISSUE_KEY;...

ycli tracker transitions list

List available transitions for issue ISSUE_KEY.

Usage:

$ ycli tracker transitions list [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker transitions execute

Execute transition ID on issue ISSUE_KEY; -F gives the fields its screen asks for.

Usage:

$ ycli tracker transitions execute [OPTIONS] ISSUE_KEY ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • ID: Transition id (from transitions list). [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker worklog

Tracker issue worklog.

Usage:

$ ycli tracker worklog [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all worklog entries for issue...
  • search: Search org-wide worklog by author and/or...
  • list-global: List org-wide worklog via GET /worklog...
  • create: Log time spent on issue ISSUE_KEY (POST...
  • update: Edit worklog RECORD_ID on issue ISSUE_KEY...
  • delete: Delete worklog RECORD_ID from issue...
  • import: Import a worklog onto issue ISSUE_KEY...

ycli tracker worklog list

List all worklog entries for issue ISSUE_KEY (auto-paginated; --all for everything).

Usage:

$ ycli tracker worklog list [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Search org-wide worklog by author and/or time range (POST /worklog/_search).

Usage:

$ ycli tracker worklog search [OPTIONS]

Options:

  • --created-by TEXT: Author login or id.
  • --created-from TEXT: Range start, YYYY-MM-DDThh🇲🇲ss.
  • --created-to TEXT: Range end, YYYY-MM-DDThh🇲🇲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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker worklog list-global

List org-wide worklog via GET /worklog (createdAt filters need --created-by).

Usage:

$ ycli tracker worklog list-global [OPTIONS]

Options:

  • --created-by TEXT: Author login or id.
  • --created-from TEXT: Range start, YYYY-MM-DDThh🇲🇲ss.
  • --created-to TEXT: Range end, YYYY-MM-DDThh🇲🇲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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker worklog create

Log time spent on issue ISSUE_KEY (POST /issues/{key}/worklog).

Usage:

$ ycli tracker worklog create [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --duration TEXT: Time spent, ISO-8601 duration (e.g. PT2H, PT300M, P1DT3H). [required]
  • --start TEXT: Work start time, YYYY-MM-DDThh🇲🇲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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker worklog update

Edit worklog RECORD_ID on issue ISSUE_KEY — only supplied fields are sent.

Usage:

$ ycli tracker worklog update [OPTIONS] ISSUE_KEY RECORD_ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • RECORD_ID: Worklog record id to edit/delete. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker worklog delete

Delete worklog RECORD_ID from issue ISSUE_KEY.

Usage:

$ ycli tracker worklog delete [OPTIONS] ISSUE_KEY RECORD_ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • RECORD_ID: Worklog record id to edit/delete. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker worklog import

Import a worklog onto issue ISSUE_KEY (POST /issues/{issue_key}/worklogs/_import).

Usage:

$ ycli tracker worklog import [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --duration TEXT: Time spent, ISO-8601 duration (e.g. PT1H). [required]
  • --created-at TEXT: Original creation time, YYYY-MM-DDThh🇲🇲ss.sss±hhmm. [required]
  • --created-by TEXT: Login or id of the original author. [required]
  • --start TEXT: Work start time, YYYY-MM-DDThh🇲🇲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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker changelog

Tracker issue changelog.

Usage:

$ ycli tracker changelog [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all changelog entries for issue...

ycli tracker changelog list

List all changelog entries for issue ISSUE_KEY (auto-paginated; --all for everything).

Usage:

$ ycli tracker changelog list [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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.
  • --field TEXT: Only changes of this field, e.g. status.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: 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.
  • --help: Show this message and exit.

ycli tracker checklists

Tracker issue checklists.

Usage:

$ ycli tracker checklists [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List the checklist items on issue ISSUE_KEY.
  • create: Add a checklist item to issue ISSUE_KEY...
  • update: Edit checklist item ITEM_ID on issue...
  • delete: Delete checklist item ITEM_ID from issue...
  • clear: Delete the entire checklist from issue...

ycli tracker checklists list

List the checklist items on issue ISSUE_KEY.

Usage:

$ ycli tracker checklists list [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker checklists create

Add a checklist item to issue ISSUE_KEY (creates the checklist if absent).

Usage:

$ ycli tracker checklists create [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --text TEXT: Item text. [required]
  • --checked / --no-checked: Done flag.
  • --assignee TEXT: Assignee login or id.
  • --deadline TEXT: Deadline date, YYYY-MM-DDThh🇲🇲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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker checklists update

Edit checklist item ITEM_ID on issue ISSUE_KEY — only supplied fields are sent.

Usage:

$ ycli tracker checklists update [OPTIONS] ISSUE_KEY ITEM_ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • ITEM_ID: Checklist item id. [required]

Options:

  • --text TEXT: Item text.
  • --checked / --no-checked: Done flag.
  • --assignee TEXT: Assignee login or id.
  • --deadline TEXT: Deadline date, YYYY-MM-DDThh🇲🇲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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker checklists delete

Delete checklist item ITEM_ID from issue ISSUE_KEY.

Usage:

$ ycli tracker checklists delete [OPTIONS] ISSUE_KEY ITEM_ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • ITEM_ID: Checklist item id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker checklists clear

Delete the entire checklist from issue ISSUE_KEY.

Usage:

$ ycli tracker checklists clear [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker columns

Tracker agile board columns.

Usage:

$ ycli tracker columns [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all columns on board BOARD_ID.
  • get: Get one column COLUMN_ID on board BOARD_ID.
  • create: Create a column on board BOARD_ID (POST...
  • update: Edit column COLUMN_ID on board BOARD_ID...
  • delete: Delete column COLUMN_ID on board BOARD_ID...

ycli tracker columns list

List all columns on board BOARD_ID.

Usage:

$ ycli tracker columns list [OPTIONS] BOARD_ID

Arguments:

  • BOARD_ID: Numeric board identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker columns get

Get one column COLUMN_ID on board BOARD_ID.

Usage:

$ ycli tracker columns get [OPTIONS] BOARD_ID COLUMN_ID

Arguments:

  • BOARD_ID: Numeric board identifier. [required]
  • COLUMN_ID: Numeric column identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker columns create

Create a column on board BOARD_ID (POST /boards/{board_id}/columns/).

Usage:

$ ycli tracker columns create [OPTIONS] BOARD_ID

Arguments:

  • BOARD_ID: Numeric board identifier. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker columns update

Edit column COLUMN_ID on board BOARD_ID (PATCH) — only supplied fields are sent.

Usage:

$ ycli tracker columns update [OPTIONS] BOARD_ID COLUMN_ID

Arguments:

  • BOARD_ID: Numeric board identifier. [required]
  • COLUMN_ID: Numeric column identifier. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker columns delete

Delete column COLUMN_ID on board BOARD_ID (DELETE /boards/{board_id}/columns/{column_id}).

Usage:

$ ycli tracker columns delete [OPTIONS] BOARD_ID COLUMN_ID

Arguments:

  • BOARD_ID: Numeric board identifier. [required]
  • COLUMN_ID: Numeric column identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker priorities

Tracker priorities.

Usage:

$ ycli tracker priorities [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all priorities.
  • create: Create a priority (POST /priorities/).
  • update: Edit priority PRIORITY_ID (PATCH...

ycli tracker priorities list

List all priorities.

Usage:

$ ycli tracker priorities list [OPTIONS]

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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker priorities create

Create a priority (POST /priorities/).

Usage:

$ ycli tracker priorities create [OPTIONS]

Options:

  • --key TEXT: Key of the new priority. [required]
  • --order INTEGER: Display-order weight of the priority. [required]
  • --name-ru TEXT: Priority name in Russian.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker priorities update

Edit priority PRIORITY_ID (PATCH /priorities/{id}?version=).

Usage:

$ ycli tracker priorities update [OPTIONS] PRIORITY_ID

Arguments:

  • PRIORITY_ID: Priority id or key. [required]

Options:

  • --name-ru TEXT: New priority name in Russian.
  • --name-en TEXT: New priority name in English.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issuetypes

Tracker issue types.

Usage:

$ ycli tracker issuetypes [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all issue types.
  • create: Create an issue type (POST /issuetypes/).
  • update: Edit issue type ISSUE_TYPE_ID (PATCH...

ycli tracker issuetypes list

List all issue types.

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issuetypes create

Create an issue type (POST /issuetypes/).

Usage:

$ ycli tracker issuetypes create [OPTIONS]

Options:

  • --key TEXT: Key of the new issue type. [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker issuetypes update

Edit issue type ISSUE_TYPE_ID (PATCH /issuetypes/{id}?version=).

Usage:

$ ycli tracker issuetypes update [OPTIONS] ISSUE_TYPE_ID

Arguments:

  • ISSUE_TYPE_ID: Issue type id or key. [required]

Options:

  • --name-ru TEXT: New issue type name in Russian.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker linktypes

Tracker link types.

Usage:

$ ycli tracker linktypes [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all link types.

ycli tracker linktypes list

List all link types.

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker users

Tracker organisation users.

Usage:

$ ycli tracker users [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • get: Get one user account by LOGIN_OR_ID.
  • list: List all organisation users...

ycli tracker users get

Get one user account by LOGIN_OR_ID.

Usage:

$ ycli tracker users get [OPTIONS] LOGIN_OR_ID

Arguments:

  • LOGIN_OR_ID: User login or uid (login:12345 if numeric). [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker users list

List all organisation users (auto-paginated; --all for everything).

Usage:

$ ycli tracker users list [OPTIONS]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker statuses

Tracker issue statuses.

Usage:

$ ycli tracker statuses [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all issue statuses.
  • create: Create an issue status (POST /statuses/).
  • update: Edit issue status STATUS_ID (PATCH...

ycli tracker statuses list

List all issue statuses.

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker statuses create

Create an issue status (POST /statuses/).

Usage:

$ ycli tracker statuses create [OPTIONS]

Options:

  • --key TEXT: Key of the new status (Latin, lower-case start). [required]
  • --type TEXT: Status type. Known values: new, inProgress, paused, done, cancelled. [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker statuses update

Edit issue status STATUS_ID (PATCH /statuses/{id}?version=).

Usage:

$ ycli tracker statuses update [OPTIONS] STATUS_ID

Arguments:

  • STATUS_ID: Status id or key. [required]

Options:

  • --name-ru TEXT: New status name in Russian.
  • --name-en TEXT: New status name in English.
  • --description TEXT: New status description.
  • --type TEXT: New status type. Known values: new, inProgress, paused, done, cancelled.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker resolutions

Tracker issue resolutions.

Usage:

$ ycli tracker resolutions [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all issue resolutions.
  • create: Create an issue resolution (POST...
  • update: Edit issue resolution RESOLUTION_ID (PATCH...

ycli tracker resolutions list

List all issue resolutions.

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker resolutions create

Create an issue resolution (POST /resolutions/).

Usage:

$ ycli tracker resolutions create [OPTIONS]

Options:

  • --key TEXT: Key of the new resolution (Latin, lower-case start). [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker resolutions update

Edit issue resolution RESOLUTION_ID (PATCH /resolutions/{id}?version=).

Usage:

$ ycli tracker resolutions update [OPTIONS] RESOLUTION_ID

Arguments:

  • RESOLUTION_ID: Resolution id or key. [required]

Options:

  • --name-ru TEXT: New resolution name in Russian.
  • --name-en TEXT: New resolution name in English.
  • --description TEXT: New resolution description.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues

Tracker queues.

Usage:

$ ycli tracker queues [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all queues (auto-paginated over...
  • get: Print one queue's settings for QUEUE_ID.
  • tags-list: List the tags added to QUEUE_ID.
  • versions-list: List the versions defined on QUEUE_ID.
  • fields-list: List the required/local fields of QUEUE_ID.
  • create: Create a queue (POST /queues/).
  • delete: Delete QUEUE_ID (DELETE /queues/{queue_id}).
  • restore: Restore a deleted QUEUE_ID (POST...
  • permissions-update: Manage access to QUEUE_ID (PATCH...
  • tags-delete: Remove TAG from QUEUE_ID (POST...
  • versions-create: Create a queue version (POST /versions/).
  • versions-get: Print queue version VERSION_ID (GET...
  • versions-update: Edit queue version VERSION_ID (PATCH...
  • versions-delete: Delete queue version VERSION_ID (DELETE...
  • user-permissions-get: Show what USER may do in QUEUE_ID (GET...
  • group-permissions-get: Show what GROUP_ID may do in QUEUE_ID (GET...

ycli tracker queues list

List all queues (auto-paginated over pages; --all for everything).

Usage:

$ ycli tracker queues list [OPTIONS]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues get

Print one queue's settings for QUEUE_ID.

Usage:

$ ycli tracker queues get [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues tags-list

List the tags added to QUEUE_ID.

Usage:

$ ycli tracker queues tags-list [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues versions-list

List the versions defined on QUEUE_ID.

Usage:

$ ycli tracker queues versions-list [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues fields-list

List the required/local fields of QUEUE_ID.

Usage:

$ ycli tracker queues fields-list [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues create

Create a queue (POST /queues/).

Usage:

$ ycli tracker queues create [OPTIONS]

Options:

  • --key TEXT: Key of the new queue (case-sensitive, e.g. DESIGN). [required]
  • --name TEXT: Human-readable name of the queue. [required]
  • --lead TEXT: Login or id of the queue owner (lead). [required]
  • --default-type TEXT: Key/id of the default issue type. [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues delete

Delete QUEUE_ID (DELETE /queues/{queue_id}).

Usage:

$ ycli tracker queues delete [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues restore

Restore a deleted QUEUE_ID (POST /queues/{queue_id}/_restore; admin only).

Usage:

$ ycli tracker queues restore [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues permissions-update

Manage access to QUEUE_ID (PATCH /queues/{queue_id}/permissions).

Each scope is a JSON object of users/groups/roles, e.g. --grant '{"roles": {"add": ["author"]}}'. Pass at least one scope.

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.

Usage:

$ ycli tracker queues permissions-update [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • --create TEXT: Create-issue permission scope as a JSON object.
  • --write TEXT: Edit-issue permission scope as a JSON object.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues tags-delete

Remove TAG from QUEUE_ID (POST /queues/{queue_id}/tags/_remove; admin only).

Usage:

$ ycli tracker queues tags-delete [OPTIONS] QUEUE_ID TAG

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • TAG: Name of the tag to remove. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues versions-create

Create a queue version (POST /versions/).

Usage:

$ ycli tracker queues versions-create [OPTIONS]

Options:

  • --queue TEXT: Key of the queue to create the version in. [required]
  • --name TEXT: Name of the new version. [required]
  • --description TEXT: Description of the version.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues versions-get

Print queue version VERSION_ID (GET /versions/{id}).

Usage:

$ ycli tracker queues versions-get [OPTIONS] VERSION_ID

Arguments:

  • VERSION_ID: Numeric id of the queue version. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues versions-update

Edit queue version VERSION_ID (PATCH /versions/{id}); only the given options change.

Usage:

$ ycli tracker queues versions-update [OPTIONS] VERSION_ID

Arguments:

  • VERSION_ID: Numeric id of the queue version. [required]

Options:

  • --name TEXT: New name of the version.
  • --description TEXT: New description of the version.
  • --start-date TEXT: New version start date (YYYY-MM-DD).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues versions-delete

Delete queue version VERSION_ID (DELETE /versions/{id}).

Usage:

$ ycli tracker queues versions-delete [OPTIONS] VERSION_ID

Arguments:

  • VERSION_ID: Numeric id of the queue version. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues user-permissions-get

Show what USER may do in QUEUE_ID (GET /queues/{id}/permissions/users/{user}).

Usage:

$ ycli tracker queues user-permissions-get [OPTIONS] QUEUE_ID USER

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • USER: Login or numeric uid of the user. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker queues group-permissions-get

Show what GROUP_ID may do in QUEUE_ID (GET /queues/{id}/permissions/groups/{group}).

Usage:

$ ycli tracker queues group-permissions-get [OPTIONS] QUEUE_ID GROUP_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • GROUP_ID: Numeric id of the group. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker localfields

Tracker per-queue local fields.

Usage:

$ ycli tracker localfields [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List the local fields of queue QUEUE_ID.
  • get: Print one local field FIELD_KEY of queue...
  • create: Create a local field in queue QUEUE_ID...
  • update: Edit local field FIELD_KEY of queue...

ycli tracker localfields list

List the local fields of queue QUEUE_ID.

Usage:

$ ycli tracker localfields list [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker localfields get

Print one local field FIELD_KEY of queue QUEUE_ID.

Usage:

$ ycli tracker localfields get [OPTIONS] QUEUE_ID FIELD_KEY

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • FIELD_KEY: Local field key (from localfields list). [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker localfields create

Create a local field in queue QUEUE_ID (POST /queues/{id}/localFields).

Usage:

$ ycli tracker localfields create [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • --id TEXT: Identifier (key) of the new local field. [required]
  • --type TEXT: Field type FQN, e.g. …StringFieldType. [required]
  • --category TEXT: Category id (from GET /fields/categories). [required]
  • --name-ru TEXT: Field name in Russian.
  • --name-en TEXT: Field name in English.
  • --description TEXT: Description of the local field.
  • --order INTEGER: Position in the org's field list.
  • --readonly / --no-readonly: Whether the field value is read-only.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker localfields update

Edit local field FIELD_KEY of queue QUEUE_ID (PATCH …/localFields/{key}; no version lock).

Usage:

$ ycli tracker localfields update [OPTIONS] QUEUE_ID FIELD_KEY

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • FIELD_KEY: Local field key (from localfields list). [required]

Options:

  • --name-ru TEXT: New field name in Russian.
  • --name-en TEXT: New field name in English.
  • --category TEXT: New category id.
  • --description TEXT: New description of the local field.
  • --order INTEGER: New position in the field list.
  • --readonly / --no-readonly: Read-only value.
  • --visible / --no-visible: Always show the field.
  • --hidden / --no-hidden: Fully hide the field.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker fields

Tracker global fields.

Usage:

$ ycli tracker fields [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all global fields of the organisation.
  • get: Get parameters of one issue field by...
  • create: Create a global field (POST /fields).
  • update: Edit a global field FIELD_ID — rename...
  • categories-create: Create a field category (POST...
  • categories-update: Edit a field category CATEGORY_ID (PATCH...

ycli tracker fields list

List all global fields of the organisation.

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker fields get

Get parameters of one issue field by FIELD_ID.

Usage:

$ ycli tracker fields get [OPTIONS] FIELD_ID

Arguments:

  • FIELD_ID: Identifier of the issue field. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker fields create

Create a global field (POST /fields).

A name is unique among the fields: one that is taken answers 422 (measured).

Usage:

$ ycli tracker fields create [OPTIONS]

Options:

  • --id TEXT: Identifier (key) of the new field. [required]
  • --type TEXT: Field type FQN, e.g. …StringFieldType. [required]
  • --category TEXT: Category id (from fields categories). [required]
  • --name-ru TEXT: Field name in Russian.
  • --name-en TEXT: Field name in English.
  • --description TEXT: Description of the field.
  • --order INTEGER: Position in the org's field list.
  • --readonly / --no-readonly: Whether the field value is read-only.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker fields update

Edit a global field FIELD_ID — rename and/or change options (PATCH /fields/{id}?version=).

Usage:

$ ycli tracker fields update [OPTIONS] FIELD_ID

Arguments:

  • FIELD_ID: Identifier of the field. [required]

Options:

  • --name-ru TEXT: New field name in Russian.
  • --name-en TEXT: New field name in English.
  • --option TEXT: Allowed drop-down value (repeatable).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker fields categories-create

Create a field category (POST /fields/categories).

Usage:

$ ycli tracker fields categories-create [OPTIONS]

Options:

  • --order INTEGER: Display-order weight of the category. [required]
  • --name-ru TEXT: Category name in Russian.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker fields categories-update

Edit a field category CATEGORY_ID (PATCH /fields/categories/{id}?version=).

Usage:

$ ycli tracker fields categories-update [OPTIONS] CATEGORY_ID

Arguments:

  • CATEGORY_ID: Identifier of the field category. [required]

Options:

  • --name-ru TEXT: New category name in Russian.
  • --name-en TEXT: New category name in English.
  • --order INTEGER: New display-order weight.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker components

Tracker components.

Usage:

$ ycli tracker components [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all components created in the...
  • create: Create a component (POST /components).
  • update: Edit component COMPONENT_ID (PATCH...
  • list-for-queue: List the components of one queue (GET...
  • get: Print component COMPONENT_ID (GET...
  • delete: Delete component COMPONENT_ID (DELETE...
  • user-permissions-get: Show what USER may do on a component (GET...
  • group-permissions-get: Show what GROUP_ID may do on a component...

ycli tracker components list

List all components created in the organisation.

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker components create

Create a component (POST /components).

Usage:

$ ycli tracker components create [OPTIONS]

Options:

  • --name TEXT: Display name of the new component. [required]
  • --queue TEXT: Key of the queue the component is created in. [required]
  • --description TEXT: Text description of the component.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker components update

Edit component COMPONENT_ID (PATCH /components/{id}?version=).

Usage:

$ ycli tracker components update [OPTIONS] COMPONENT_ID

Arguments:

  • COMPONENT_ID: Numeric id of the component. [required]

Options:

  • --name TEXT: New display name of the component.
  • --description TEXT: New text description of the component.
  • --lead TEXT: New login of the component's owner (lead).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker components list-for-queue

List the components of one queue (GET /queues/{id}/components).

Usage:

$ ycli tracker components list-for-queue [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker components get

Print component COMPONENT_ID (GET /components/{id}).

Usage:

$ ycli tracker components get [OPTIONS] COMPONENT_ID

Arguments:

  • COMPONENT_ID: Numeric id of the component. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker components delete

Delete component COMPONENT_ID (DELETE /components/{id}).

Usage:

$ ycli tracker components delete [OPTIONS] COMPONENT_ID

Arguments:

  • COMPONENT_ID: Numeric id of the component. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker components user-permissions-get

Show what USER may do on a component (GET /components/{id}/permissions/users/{user}).

Usage:

$ ycli tracker components user-permissions-get [OPTIONS] COMPONENT_ID USER

Arguments:

  • COMPONENT_ID: Numeric id of the component. [required]
  • USER: Login or numeric uid of the user. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker components group-permissions-get

Show what GROUP_ID may do on a component (…/permissions/groups/{group}).

Usage:

$ ycli tracker components group-permissions-get [OPTIONS] COMPONENT_ID GROUP_ID

Arguments:

  • COMPONENT_ID: Numeric id of the component. [required]
  • GROUP_ID: Numeric id of the group. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker filters

Tracker saved filters.

Usage:

$ ycli tracker filters [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • get: Get parameters of one saved filter by...
  • create: Create a saved filter (POST /filters/).
  • update: Edit filter FILTER_ID (PATCH...
  • delete: Delete saved filter FILTER_ID (DELETE...

ycli tracker filters get

Get parameters of one saved filter by FILTER_ID.

Usage:

$ ycli tracker filters get [OPTIONS] FILTER_ID

Arguments:

  • FILTER_ID: Identifier of the saved filter. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker filters create

Create a saved filter (POST /filters/).

Usage:

$ ycli tracker filters create [OPTIONS]

Options:

  • --name TEXT: Display name of the new filter. [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker filters update

Edit filter FILTER_ID (PATCH /filters/{id}) — no version lock; filter is replaced whole.

Usage:

$ ycli tracker filters update [OPTIONS] FILTER_ID

Arguments:

  • FILTER_ID: Identifier of the saved filter. [required]

Options:

  • --name TEXT: New display name of the filter.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker filters delete

Delete saved filter FILTER_ID (DELETE /filters/{id}).

Usage:

$ ycli tracker filters delete [OPTIONS] FILTER_ID

Arguments:

  • FILTER_ID: Identifier of the saved filter. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker applications

Tracker external applications.

Usage:

$ ycli tracker applications [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List external applications that issues can...

ycli tracker applications list

List external applications that issues can be linked to.

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker boards

Tracker agile boards.

Usage:

$ ycli tracker boards [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all agile boards (auto-paginated;...
  • get: Get one agile board by BOARD_ID.
  • create: Create an agile board (POST /liveBoards/).
  • update: Edit an agile board BOARD_ID (PATCH...
  • delete: Delete an agile board BOARD_ID (DELETE...

ycli tracker boards list

List all agile boards (auto-paginated; --all for everything).

Usage:

$ ycli tracker boards list [OPTIONS]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker boards get

Get one agile board by BOARD_ID.

Usage:

$ ycli tracker boards get [OPTIONS] BOARD_ID

Arguments:

  • BOARD_ID: Numeric board identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker boards create

Create an agile board (POST /liveBoards/).

Usage:

$ ycli tracker boards create [OPTIONS]

Options:

  • --name TEXT: Name of the new board. [required]
  • --owner TEXT: Login or uid of the board owner.
  • --permissions TEXT: Access template: 'private' or 'public'.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker boards update

Edit an agile board BOARD_ID (PATCH /boards/{board_id}) — only supplied fields are sent.

Usage:

$ ycli tracker boards update [OPTIONS] BOARD_ID

Arguments:

  • BOARD_ID: Numeric board identifier. [required]

Options:

  • --name TEXT: New board name.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker boards delete

Delete an agile board BOARD_ID (DELETE /boards/{board_id}).

Usage:

$ ycli tracker boards delete [OPTIONS] BOARD_ID

Arguments:

  • BOARD_ID: Numeric board identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker sprints

Tracker board sprints.

Usage:

$ ycli tracker sprints [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all sprints on board BOARD_ID.
  • get: Get one sprint by SPRINT_ID.
  • create: Create a sprint (POST /sprints).
  • update: Edit a sprint SPRINT_ID (PATCH...
  • delete: Delete a sprint SPRINT_ID (DELETE...
  • start: Start a sprint SPRINT_ID (POST...
  • archive: Archive a sprint SPRINT_ID (POST...

ycli tracker sprints list

List all sprints on board BOARD_ID.

Usage:

$ ycli tracker sprints list [OPTIONS] BOARD_ID

Arguments:

  • BOARD_ID: Numeric board identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker sprints get

Get one sprint by SPRINT_ID.

Usage:

$ ycli tracker sprints get [OPTIONS] SPRINT_ID

Arguments:

  • SPRINT_ID: Numeric sprint identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker sprints create

Create a sprint (POST /sprints).

Usage:

$ ycli tracker sprints create [OPTIONS]

Options:

  • --board-id TEXT: Identifier of the board the sprint belongs to. [required]
  • --name TEXT: Name of the new sprint. [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker sprints update

Edit a sprint SPRINT_ID (PATCH /sprints/{id}?version=) — only supplied fields are sent.

Usage:

$ ycli tracker sprints update [OPTIONS] SPRINT_ID

Arguments:

  • SPRINT_ID: Numeric sprint identifier. [required]

Options:

  • --name TEXT: New sprint name.
  • --start-date TEXT: New start date (YYYY-MM-DD).
  • --end-date TEXT: New end date (YYYY-MM-DD).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker sprints delete

Delete a sprint SPRINT_ID (DELETE /sprints/{sprint_id}).

Usage:

$ ycli tracker sprints delete [OPTIONS] SPRINT_ID

Arguments:

  • SPRINT_ID: Numeric sprint identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker sprints start

Start a sprint SPRINT_ID (POST /sprints/{id}/_start?version=; status → in_progress).

Usage:

$ ycli tracker sprints start [OPTIONS] SPRINT_ID

Arguments:

  • SPRINT_ID: Numeric sprint identifier. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker sprints archive

Archive a sprint SPRINT_ID (POST /sprints/{id}/_archive?version=; status → archived).

Usage:

$ ycli tracker sprints archive [OPTIONS] SPRINT_ID

Arguments:

  • SPRINT_ID: Numeric sprint identifier. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker attachments

Tracker issue attachments.

Usage:

$ ycli tracker attachments [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List files attached to an issue (GET...
  • download: Download an attachment's raw bytes to...
  • thumbnails-download: Download a graphic attachment's preview...
  • get: Print an attachment's metadata (GET...
  • delete: Delete an attachment from an issue (DELETE...
  • upload: Attach a local file to an issue (POST...
  • upload-temp: Upload a temporary file (POST...
  • import: Import a file attachment onto issue...
  • import-for-comment: Import a file onto comment COMMENT_ID of...

ycli tracker attachments list

List files attached to an issue (GET /issues/{issue}/attachments).

Usage:

$ ycli tracker attachments list [OPTIONS] ISSUE

Arguments:

  • ISSUE: Issue key or id, e.g. JUNE-2. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker attachments download

Download an attachment's raw bytes to --output (or stdout). Binary is CLI/SDK-only.

Usage:

$ ycli tracker attachments download [OPTIONS] ISSUE FILE_ID FILENAME

Arguments:

  • ISSUE: Issue key or id, e.g. JUNE-2. [required]
  • FILE_ID: Attachment file id. [required]
  • FILENAME: Attachment file name. [required]

Options:

  • -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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker attachments thumbnails-download

Download a graphic attachment's preview thumbnail to --output (or stdout).

Usage:

$ ycli tracker attachments thumbnails-download [OPTIONS] ISSUE FILE_ID

Arguments:

  • ISSUE: Issue key or id, e.g. JUNE-2. [required]
  • FILE_ID: Attachment file id. [required]

Options:

  • -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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker attachments get

Print an attachment's metadata (GET /issues/{issue}/attachments/{file_id}).

Usage:

$ ycli tracker attachments get [OPTIONS] ISSUE FILE_ID

Arguments:

  • ISSUE: Issue key or id, e.g. JUNE-2. [required]
  • FILE_ID: Attachment file id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker attachments delete

Delete an attachment from an issue (DELETE /issues/{issue}/attachments/{file_id}).

Usage:

$ ycli tracker attachments delete [OPTIONS] ISSUE FILE_ID

Arguments:

  • ISSUE: Issue key or id, e.g. JUNE-2. [required]
  • FILE_ID: Attachment file id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker attachments upload

Attach a local file to an issue (POST /issues/{issue}/attachments).

Usage:

$ ycli tracker attachments upload [OPTIONS] ISSUE FILE_PATH

Arguments:

  • ISSUE: Issue key or id, e.g. JUNE-2. [required]
  • FILE_PATH: Local file to upload. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker attachments upload-temp

Upload a temporary file (POST /attachments); its id attaches once to an issue or comment.

Usage:

$ ycli tracker attachments upload-temp [OPTIONS] FILE_PATH

Arguments:

  • FILE_PATH: Local file to upload. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker attachments import

Import a file attachment onto issue ISSUE_KEY (POST …/attachments/_import).

Usage:

$ ycli tracker attachments import [OPTIONS] ISSUE_KEY PATH

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • PATH: Local file to attach. [required]

Options:

  • --created-at TEXT: Original creation time, YYYY-MM-DDThh🇲🇲ss.sss±hhmm. [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker attachments import-for-comment

Import a file onto comment COMMENT_ID of issue ISSUE_KEY (…/comments/{id}/…/_import).

Usage:

$ ycli tracker attachments import-for-comment [OPTIONS] ISSUE_KEY COMMENT_ID PATH

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • COMMENT_ID: Id of the comment. [required]
  • PATH: Local file to attach. [required]

Options:

  • --created-at TEXT: Original creation time, YYYY-MM-DDThh🇲🇲ss.sss±hhmm. [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker macros

Tracker queue macros.

Usage:

$ ycli tracker macros [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List the macros of QUEUE_ID.
  • get: Get macro MACRO_ID of QUEUE_ID.
  • create: Create a macro on QUEUE_ID (POST...
  • update: Edit macro MACRO_ID of QUEUE_ID (PATCH) —...
  • delete: Delete macro MACRO_ID of QUEUE_ID (DELETE).

ycli tracker macros list

List the macros of QUEUE_ID.

Usage:

$ ycli tracker macros list [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker macros get

Get macro MACRO_ID of QUEUE_ID.

Usage:

$ ycli tracker macros get [OPTIONS] QUEUE_ID MACRO_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • MACRO_ID: Numeric macro identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker macros create

Create a macro on QUEUE_ID (POST /queues/{queue_id}/macros).

Usage:

$ ycli tracker macros create [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • --name TEXT: Name of the new macro. [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker macros update

Edit macro MACRO_ID of QUEUE_ID (PATCH) — only supplied fields are sent.

Usage:

$ ycli tracker macros update [OPTIONS] QUEUE_ID MACRO_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • MACRO_ID: Numeric macro identifier. [required]

Options:

  • --name TEXT: New name of the macro.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker macros delete

Delete macro MACRO_ID of QUEUE_ID (DELETE).

Usage:

$ ycli tracker macros delete [OPTIONS] QUEUE_ID MACRO_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • MACRO_ID: Numeric macro identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker triggers

Tracker queue triggers.

Usage:

$ ycli tracker triggers [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List the triggers of QUEUE_ID...
  • get: Get trigger TRIGGER_ID of QUEUE_ID.
  • create: Create a trigger on QUEUE_ID (POST...
  • update: Edit trigger TRIGGER_ID of QUEUE_ID (PATCH...
  • webhook-log-list: List the HTTP-action (Webhook) run logs of...

ycli tracker triggers list

List the triggers of QUEUE_ID (auto-paginated; --all for everything).

Usage:

$ ycli tracker triggers list [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker triggers get

Get trigger TRIGGER_ID of QUEUE_ID.

Usage:

$ ycli tracker triggers get [OPTIONS] QUEUE_ID TRIGGER_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • TRIGGER_ID: Numeric trigger identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker triggers create

Create a trigger on QUEUE_ID (POST /queues/{queue_id}/triggers).

Pass one or more --action JSON objects (and optional --condition JSON objects), e.g. --action '{"type": "Transition", "status": {"key": "open"}}'.

Usage:

$ ycli tracker triggers create [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • --name TEXT: Name of the new trigger. [required]
  • --action TEXT: Trigger action as a JSON object (repeatable).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker triggers update

Edit trigger TRIGGER_ID of QUEUE_ID (PATCH ...?version=) — only supplied fields are sent.

Usage:

$ ycli tracker triggers update [OPTIONS] QUEUE_ID TRIGGER_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • TRIGGER_ID: Numeric trigger identifier. [required]

Options:

  • --name TEXT: New name of the trigger.
  • --action TEXT: Trigger action as a JSON object (repeatable).
  • --condition TEXT: Trigger condition as a JSON object (repeatable).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker triggers webhook-log-list

List the HTTP-action (Webhook) run logs of trigger TRIGGER_ID.

Usage:

$ ycli tracker triggers webhook-log-list [OPTIONS] QUEUE_ID TRIGGER_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • TRIGGER_ID: Numeric trigger identifier. [required]

Options:

  • --issue-id TEXT: Scope the logs to one issue key/id.
  • --limit INTEGER: Max records (API default 10, max 100).
  • --date-from TEXT: Range start (YYYY-MM-DDThh🇲🇲ss.sss±hhmm).
  • --date-to TEXT: Range end (YYYY-MM-DDThh🇲🇲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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker autoactions

Tracker queue autoactions.

Usage:

$ ycli tracker autoactions [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • get: Get autoaction ACTION_ID of QUEUE_ID.
  • create: Create an autoaction on QUEUE_ID (POST...
  • logs-list: List the run summaries of autoaction...
  • logs-get: List the per-issue outcomes of run RUN_ID...

ycli tracker autoactions get

Get autoaction ACTION_ID of QUEUE_ID.

Usage:

$ ycli tracker autoactions get [OPTIONS] QUEUE_ID ACTION_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • ACTION_ID: Numeric autoaction identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker autoactions create

Create an autoaction on QUEUE_ID (POST /queues/{queue_id}/autoactions).

Supply --query or --filter to select issues, and one or more --action JSON objects, e.g. --action '{"type": "Transition", "status": {"key": "needInfo"}}'.

Usage:

$ ycli tracker autoactions create [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • --name TEXT: Name of the new autoaction. [required]
  • --query TEXT: TQL query selecting the issues to act on.
  • --filter TEXT: Field-based filter as a JSON object.
  • --action TEXT: Autoaction action as a JSON object (repeatable).
  • --active / --inactive: Start active or disabled.
  • --notify / --no-notify: Send notifications when the autoaction runs.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker autoactions logs-list

List the run summaries of autoaction ACTION_ID.

Usage:

$ ycli tracker autoactions logs-list [OPTIONS] QUEUE_ID ACTION_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • ACTION_ID: Numeric autoaction identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker autoactions logs-get

List the per-issue outcomes of run RUN_ID of autoaction ACTION_ID.

Usage:

$ ycli tracker autoactions logs-get [OPTIONS] QUEUE_ID ACTION_ID RUN_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]
  • ACTION_ID: Numeric autoaction identifier. [required]
  • RUN_ID: Autoaction run identifier. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker bulk

Tracker async bulk changes.

Usage:

$ ycli tracker bulk [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • get: Print the current status of bulk-change...
  • issues-list: List the issues of a bulk change, each...

ycli tracker bulk get

Print the current status of bulk-change BULK_ID (GET /bulkchange/{id}).

Usage:

$ ycli tracker bulk get [OPTIONS] BULK_ID

Arguments:

  • BULK_ID: Bulk-change operation id from a trigger. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker bulk issues-list

List the issues of a bulk change, each with how it went (GET /bulkchange/{id}/issues).

One record per issue, the ones that went well too (status COMPLETED); a failed one carries its error.

Usage:

$ ycli tracker bulk issues-list [OPTIONS] BULK_ID

Arguments:

  • BULK_ID: Bulk-change operation id from a trigger. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Tracker issue external-app links.

Usage:

$ ycli tracker remotelinks [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List external links on issue ISSUE_KEY...
  • create: Add an external link to issue ISSUE_KEY...
  • delete: Delete external link LINK_ID from issue...

List external links on issue ISSUE_KEY (GET /issues/{issue_key}/remotelinks).

Usage:

$ ycli tracker remotelinks list [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Add an external link to issue ISSUE_KEY (POST /issues/{issue_key}/remotelinks).

Usage:

$ ycli tracker remotelinks create [OPTIONS] ISSUE_KEY

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]

Options:

  • --key TEXT: Key of the object in the external app. [required]
  • --origin TEXT: Identifier of an external application the organization has (tracker applications list). [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Delete external link LINK_ID from issue ISSUE_KEY (DELETE …/remotelinks/{id}).

Usage:

$ ycli tracker remotelinks delete [OPTIONS] ISSUE_KEY LINK_ID

Arguments:

  • ISSUE_KEY: Issue key, e.g. DATAENGINEERING-1. [required]
  • LINK_ID: Remote-link id to delete. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker dashboards

Tracker dashboards.

Usage:

$ ycli tracker dashboards [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • create: Create a dashboard (POST /dashboards/).
  • widgets-create-cycle-time: Add a cycle-time widget to DASHBOARD_ID...

ycli tracker dashboards create

Create a dashboard (POST /dashboards/).

Usage:

$ ycli tracker dashboards create [OPTIONS]

Options:

  • --name TEXT: Dashboard name. [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker dashboards widgets-create-cycle-time

Add a cycle-time widget to DASHBOARD_ID (POST /dashboards/{id}/widgets/cycleTime).

Usage:

$ ycli tracker dashboards widgets-create-cycle-time [OPTIONS] DASHBOARD_ID

Arguments:

  • DASHBOARD_ID: Target dashboard id. [required]

Options:

  • --description TEXT: Widget name. [required]
  • --query TEXT: Query-language filter selecting issues.
  • --from-status TEXT: Status key work starts from (repeatable).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities

Tracker projects, portfolios and goals.

Usage:

$ ycli tracker entities [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • get: Print a single entity...
  • create: Create an entity (POST...
  • update: Edit entity ID (PATCH...
  • delete: Delete entity ID (DELETE...
  • search: Search entities of ENTITY_TYPE (POST...
  • events-list: Print an entity's event history (GET...
  • permissions-get: Print an entity's access settings (GET...
  • permissions-update: Set an entity's access settings (PATCH...
  • permissions-get-direct: Print an entity's direct READ/WRITE/GRANT...
  • permissions-update-direct: Grant and revoke an entity's direct rights...
  • update-bulk: Mass-edit entities (POST...
  • bulk-get: Print a bulk-change operation's status...
  • reports-create: Build an issue report (POST...
  • comments: Entity comments.
  • checklists: Entity checklists.
  • links: Entity links.
  • attachments: Entity attachments.

ycli tracker entities get

Print a single entity (project/portfolio/goal) by ID.

Usage:

$ ycli tracker entities get [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities create

Create an entity (POST /entities/ENTITY_TYPE). summary is required; other fields optional.

Usage:

$ ycli tracker entities create [OPTIONS] ENTITY_TYPE

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]

Options:

  • --summary TEXT: Entity name (required). [required]
  • --description TEXT: Description.
  • --lead TEXT: Responsible user id/login.
  • --author TEXT: Author user id/login.
  • --status TEXT: entityStatus key to set.
  • --start TEXT: Start date, YYYY-MM-DDThh🇲🇲ss.sss±hhmm.
  • --end TEXT: Deadline date, YYYY-MM-DDThh🇲🇲ss.sss±hhmm.
  • --parent TEXT: Primary parent portfolio/goal id.
  • --team-user TEXT: Participant id/login (repeatable).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities update

Edit entity ID (PATCH /entities/ENTITY_TYPE/ID) — only supplied fields are sent.

Usage:

$ ycli tracker entities update [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --summary TEXT: New name.
  • --description TEXT: New description.
  • --lead TEXT: New responsible user id/login.
  • --author TEXT: New author user id/login.
  • --status TEXT: New entityStatus key.
  • --start TEXT: New start date.
  • --end TEXT: New deadline date.
  • --parent TEXT: New primary parent portfolio/goal id.
  • --team-user TEXT: Participant id/login (repeatable).
  • --tag TEXT: Tag (repeatable).
  • --comment TEXT: Comment to add with the change.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities delete

Delete entity ID (DELETE /entities/ENTITY_TYPE/ID).

Usage:

$ ycli tracker entities delete [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Search entities of ENTITY_TYPE (POST /entities/ENTITY_TYPE/_search; --all for all).

Usage:

$ ycli tracker entities search [OPTIONS] ENTITY_TYPE

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]

Options:

  • --input-text TEXT: Substring in the entity name.
  • --filter TEXT: Filter key=value (JSON-coerced; repeatable).
  • --order-by TEXT: Field key to sort by.
  • --order-asc / --no-order-asc: Sort ascending.
  • --root-only / --no-root-only: Only top-level entities.
  • --fields TEXT: Comma-separated extra fields to include.
  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities events-list

Print an entity's event history (GET …/events/_relative, auto-paginated).

Usage:

$ ycli tracker entities events-list [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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.
  • --selected TEXT: Event id to build the list around.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities permissions-get

Print an entity's access settings (GET …/extendedPermissions).

Usage:

$ ycli tracker entities permissions-get [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities permissions-update

Set an entity's access settings (PATCH …/extendedPermissions).

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.

Usage:

$ ycli tracker entities permissions-update [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities permissions-get-direct

Print an entity's direct READ/WRITE/GRANT rights, no inheritance (GET …/permissions).

Usage:

$ ycli tracker entities permissions-get-direct [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities permissions-update-direct

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:

$ ycli tracker entities permissions-update-direct [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities update-bulk

Mass-edit entities (POST …/bulkchange/_update) — returns the async operation handle.

Usage:

$ ycli tracker entities update-bulk [OPTIONS] ENTITY_TYPE

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]

Options:

  • --entity TEXT: Entity id (repeatable). [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: 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.
  • --help: Show this message and exit.

ycli tracker entities bulk-get

Print a bulk-change operation's status (GET /bulkchange/OPERATION_ID).

Usage:

$ ycli tracker entities bulk-get [OPTIONS] BULK_ID

Arguments:

  • BULK_ID: Bulk-change id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities reports-create

Build an issue report (POST /entities/report/) from a TQL query and column fields.

Usage:

$ ycli tracker entities reports-create [OPTIONS]

Options:

  • --summary TEXT: Report name (required). [required]
  • --query TEXT: Issue filter in Tracker Query Language (required). [required]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: 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.
  • --help: Show this message and exit.

ycli tracker entities comments

Entity comments.

Usage:

$ ycli tracker entities comments [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List comments on an entity (GET...
  • get: Get one comment on an entity (GET...
  • create: Add a comment to an entity (POST …/comments).
  • update: Edit a comment on an entity (PATCH...
  • delete: Delete a comment from an entity (DELETE...

ycli tracker entities comments list

List comments on an entity (GET …/comments; --limit or --all pages …/comments/_relative).

--expand (html, attachments, reactions or all) goes with the plain listing: the paged one does not take it.

Usage:

$ ycli tracker entities comments list [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities comments get

Get one comment on an entity (GET …/comments/COMMENT_ID).

Usage:

$ ycli tracker entities comments get [OPTIONS] ENTITY_TYPE ID COMMENT_ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • COMMENT_ID: Comment id. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities comments create

Add a comment to an entity (POST …/comments).

Usage:

$ ycli tracker entities comments create [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --text TEXT: Comment text — pass "$(cat note.md)" for markdown. [required]
  • --summon TEXT: User to summon (repeatable).
  • --expand TEXT: Extra blocks to include in the reply.
  • --is-add-to-followers / --no-is-add-to-followers: Add the comment's author to the followers (the API adds by default).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities comments update

Edit a comment on an entity (PATCH …/comments/COMMENT_ID).

Usage:

$ ycli tracker entities comments update [OPTIONS] ENTITY_TYPE ID COMMENT_ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • COMMENT_ID: Comment id. [required]

Options:

  • --text TEXT: New comment text. [required]
  • --expand TEXT: Extra blocks to include in the reply.
  • --is-add-to-followers / --no-is-add-to-followers: Add the comment's author to the followers (the API adds by default).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities comments delete

Delete a comment from an entity (DELETE …/comments/COMMENT_ID).

Usage:

$ ycli tracker entities comments delete [OPTIONS] ENTITY_TYPE ID COMMENT_ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • COMMENT_ID: Comment id. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities checklists

Entity checklists.

Usage:

$ ycli tracker entities checklists [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • create: Add checklist items to an entity (POST...
  • update: Replace the whole checklist (PATCH...
  • items-update: Edit a single checklist item (PATCH...
  • items-delete: Remove one checklist item (DELETE...
  • delete: Clear the whole checklist (DELETE...
  • move: Reorder a checklist item (POST...

ycli tracker entities checklists create

Add checklist items to an entity (POST …/checklistItems).

Usage:

$ ycli tracker entities checklists create [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --text TEXT: Item text (repeatable — one per item). [required]
  • --expand TEXT: Extra blocks to include in the reply.
  • --fields TEXT: Comma-separated fields to include in the reply.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities checklists update

Replace the whole checklist (PATCH …/checklistItems) from repeated --item id=text.

The text is sent verbatim — never JSON-coerced — and only the first = splits: --item 5f=true sends the text true, --item 6a=a=b sends a=b.

Usage:

$ ycli tracker entities checklists update [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --item TEXT: Item as id=text (repeatable — replaces the whole checklist). [required]
  • --expand TEXT: Extra blocks to include in the reply.
  • --fields TEXT: Comma-separated fields to include in the reply.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities checklists items-update

Edit a single checklist item (PATCH …/checklistItems/ITEM_ID).

Usage:

$ ycli tracker entities checklists items-update [OPTIONS] ENTITY_TYPE ID ITEM_ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • ITEM_ID: Checklist item id. [required]

Options:

  • --text TEXT: New item text.
  • --checked / --no-checked: Mark the item done or not done.
  • --assignee TEXT: Assignee user id/login.
  • --deadline TEXT: Deadline date, YYYY-MM-DDThh🇲🇲ss.sss±hhmm.
  • --deadline-type TEXT: Deadline kind: date or quarter; the API requires it.
  • --expand TEXT: Extra blocks to include in the reply.
  • --fields TEXT: Comma-separated fields to include in the reply.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities checklists items-delete

Remove one checklist item (DELETE …/checklistItems/ITEM_ID).

Usage:

$ ycli tracker entities checklists items-delete [OPTIONS] ENTITY_TYPE ID ITEM_ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • ITEM_ID: Checklist item id. [required]

Options:

  • --expand TEXT: Extra blocks to include in the reply.
  • --fields TEXT: Comma-separated fields to include in the reply.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities checklists delete

Clear the whole checklist (DELETE …/checklistItems).

Usage:

$ ycli tracker entities checklists delete [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --expand TEXT: Extra blocks to include in the reply.
  • --fields TEXT: Comma-separated fields to include in the reply.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities checklists move

Reorder a checklist item (POST …/checklistItems/ITEM_ID/_move).

Usage:

$ ycli tracker entities checklists move [OPTIONS] ENTITY_TYPE ID ITEM_ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • ITEM_ID: Checklist item id. [required]

Options:

  • --before TEXT: Item id to insert the moved item before.
  • --expand TEXT: Extra blocks to include in the reply.
  • --fields TEXT: Comma-separated fields to include in the reply.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Entity links.

Usage:

$ ycli tracker entities links [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List an entity's links to other entities...
  • create: Create a link between entities (POST...
  • delete: Delete a link (DELETE …/links?right=RIGHT).

List an entity's links to other entities (GET …/links).

Usage:

$ ycli tracker entities links list [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Create a link between entities (POST …/links).

Usage:

$ ycli tracker entities links create [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Delete a link (DELETE …/links?right=RIGHT).

Usage:

$ ycli tracker entities links delete [OPTIONS] ENTITY_TYPE ID RIGHT

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • RIGHT: Id of the entity to unlink. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities attachments

Entity attachments.

Usage:

$ ycli tracker entities attachments [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List files attached to an entity (GET...
  • get: Get one attachment's metadata (GET...
  • download: Download an attachment's raw bytes to...
  • attach: Attach a previously uploaded temp file to...
  • delete: Detach a file from an entity (DELETE...

ycli tracker entities attachments list

List files attached to an entity (GET …/attachments).

Usage:

$ ycli tracker entities attachments list [OPTIONS] ENTITY_TYPE ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities attachments get

Get one attachment's metadata (GET …/attachments/FILE_ID).

Usage:

$ ycli tracker entities attachments get [OPTIONS] ENTITY_TYPE ID FILE_ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • FILE_ID: Attachment file id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities attachments download

Download an attachment's raw bytes to --output (or stdout). Binary is CLI/SDK-only.

Usage:

$ ycli tracker entities attachments download [OPTIONS] FILE_ID FILENAME

Arguments:

  • FILE_ID: Attachment file id. [required]
  • FILENAME: Attachment file name. [required]

Options:

  • -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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities attachments attach

Attach a previously uploaded temp file to an entity (POST …/attachments/TEMP_FILE_ID).

Usage:

$ ycli tracker entities attachments attach [OPTIONS] ENTITY_TYPE ID TEMP_FILE_ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • TEMP_FILE_ID: Temp file id. [required]

Options:

  • --expand TEXT: Extra blocks to include in the reply.
  • --fields TEXT: Comma-separated fields to include in the reply.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker entities attachments delete

Detach a file from an entity (DELETE …/attachments/FILE_ID; empty response body).

Usage:

$ ycli tracker entities attachments delete [OPTIONS] ENTITY_TYPE ID FILE_ID

Arguments:

  • ENTITY_TYPE: Entity type (report: search only). Known values: project, portfolio, goal, report. [required]
  • ID: Entity id (or shortId). [required]
  • FILE_ID: Attachment file id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker workflows

Tracker workflows.

Usage:

$ ycli tracker workflows [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List the organization's workflows (deleted...
  • get: Print workflow WORKFLOW_ID with its steps...
  • list-for-queue: Show which workflow each issue type of...
  • create: Create a workflow (POST /workflows).
  • update: Edit workflow WORKFLOW_ID (PATCH...
  • actions-update: Edit one action of a workflow step (PATCH...
  • delete: Delete workflow WORKFLOW_ID (DELETE...

ycli tracker workflows list

List the organization's workflows (deleted ones excluded).

Usage:

$ 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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker workflows get

Print workflow WORKFLOW_ID with its steps and actions.

Usage:

$ ycli tracker workflows get [OPTIONS] WORKFLOW_ID

Arguments:

  • WORKFLOW_ID: Workflow id, e.g. quickStartV2PresetWorkflow. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker workflows list-for-queue

Show which workflow each issue type of QUEUE_ID uses.

Usage:

$ ycli tracker workflows list-for-queue [OPTIONS] QUEUE_ID

Arguments:

  • QUEUE_ID: Queue key (case-sensitive) or numeric id. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker workflows create

Create a workflow (POST /workflows).

--initial-action and each --step are JSON objects as in the API docs, e.g. --initial-action '{"id":"open","name":{"ru":"Открыть","en":"Open"},"target":"open"}' --step '{"status":"open","actions":[{"id":"close","name":{"ru":"Закрыть"},"target":"closed"}]}'. Every action name needs its Russian text: Tracker refuses one without it.

Usage:

$ ycli tracker workflows create [OPTIONS]

Options:

  • --name TEXT: Name of the workflow. [required]
  • --initial-action TEXT: Initial action as a JSON object. [required]
  • --step TEXT: Step as a JSON object: status plus actions (repeatable). [required]
  • --id TEXT: Identifier of the workflow (generated if omitted).
  • --queue TEXT: Queue key to bind to (shared if omitted).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker workflows update

Edit workflow WORKFLOW_ID (PATCH /workflows/{id}?version=); only given options change.

Giving any --step replaces the whole step list.

Usage:

$ ycli tracker workflows update [OPTIONS] WORKFLOW_ID

Arguments:

  • WORKFLOW_ID: Workflow id, e.g. quickStartV2PresetWorkflow. [required]

Options:

  • --version INTEGER: Current version of the workflow (optimistic lock); see workflows get. [required]
  • --name TEXT: New name of the workflow.
  • --initial-action TEXT: New initial action as a JSON object.
  • --step TEXT: Step as a JSON object: status plus actions (repeatable).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker workflows actions-update

Edit one action of a workflow step (PATCH …/steps/{status}/actions/{action}).

Usage:

$ ycli tracker workflows actions-update [OPTIONS] WORKFLOW_ID STATUS ACTION_ID

Arguments:

  • WORKFLOW_ID: Workflow id, e.g. quickStartV2PresetWorkflow. [required]
  • STATUS: Key of the step the action leaves. [required]
  • ACTION_ID: Id of the action. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker workflows delete

Delete workflow WORKFLOW_ID (DELETE /workflows/{id}).

Usage:

$ ycli tracker workflows delete [OPTIONS] WORKFLOW_ID

Arguments:

  • WORKFLOW_ID: Workflow id, e.g. quickStartV2PresetWorkflow. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker projects

Tracker projects (legacy API).

Usage:

$ ycli tracker projects [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List the organization's projects (GET...
  • get: Print project PROJECT_ID (GET...
  • queues-list: List the queues of project PROJECT_ID (GET...
  • create: Create a project (POST /projects).
  • update: Edit project PROJECT_ID (PUT...
  • delete: Delete project PROJECT_ID (DELETE...

ycli tracker projects list

List the organization's projects (GET /projects).

Usage:

$ ycli tracker projects list [OPTIONS]

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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker projects get

Print project PROJECT_ID (GET /projects/{id}).

Usage:

$ ycli tracker projects get [OPTIONS] PROJECT_ID

Arguments:

  • PROJECT_ID: Numeric id of the project. [required]

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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker projects queues-list

List the queues of project PROJECT_ID (GET /projects/{id}/queues).

Usage:

$ ycli tracker projects queues-list [OPTIONS] PROJECT_ID

Arguments:

  • PROJECT_ID: Numeric id of the project. [required]

Options:

  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker projects create

Create a project (POST /projects).

The service binds no queue to the new project, with --queues or without it.

Usage:

$ ycli tracker projects create [OPTIONS]

Options:

  • --name TEXT: Name of the project. [required]
  • --queues TEXT: Key of a queue. The service accepts the option and binds no queue.
  • --description TEXT: Description of the project.
  • --lead TEXT: Login or id of the project's lead.
  • --status TEXT: Stage of the project. Known values: DRAFT, IN_PROGRESS, LAUNCHED, POSTPONED.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker projects update

Edit project PROJECT_ID (PUT /projects/{id}?version=); only the given options change.

Usage:

$ ycli tracker projects update [OPTIONS] PROJECT_ID

Arguments:

  • PROJECT_ID: Numeric id of the project. [required]

Options:

  • --version INTEGER: Current version of the project (required). [required]
  • --queues TEXT: Key of the queue whose issues go into the project. [required]
  • --name TEXT: New name of the project.
  • --description TEXT: Description of the project.
  • --lead TEXT: Login or id of the project's lead.
  • --status TEXT: Stage of the project. Known values: DRAFT, IN_PROGRESS, LAUNCHED, POSTPONED.
  • --start-date TEXT: Start date (YYYY-MM-DD).
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker projects delete

Delete project PROJECT_ID (DELETE /projects/{id}).

Usage:

$ ycli tracker projects delete [OPTIONS] PROJECT_ID

Arguments:

  • PROJECT_ID: Numeric id of the project. [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker gaps

Tracker employee absences (admin).

Usage:

$ ycli tracker gaps [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • create: Create absences (POST /gaps): one from...
  • search: Find the absences of USER...
  • delete: Delete absences by id (DELETE...

ycli tracker gaps create

Create absences (POST /gaps): one from --user/--workflow/--from/--to, more from --gap.

Example: --user ann --workflow trip --from 2026-07-10T00:00Z --to 2026-07-20T00:00Z

Usage:

$ ycli tracker gaps create [OPTIONS]

Options:

  • --user TEXT: Login or id of the absent user.
  • --workflow TEXT: Kind of absence. Known values: vacation, paid_day_off, illness, absence, trip, conference_trip, conference, learning, maternity, duty.
  • --date-from TEXT: Start of the absence (ISO 8601).
  • --date-to TEXT: End of the absence (ISO 8601).
  • --id TEXT: Identifier of the absence (generated if omitted).
  • --full-day / --part-day: Whether it covers whole days.
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

Find the absences of USER... overlapping a window (POST /gaps/_search; --all for all).

Usage:

$ ycli tracker gaps search [OPTIONS] USER...

Arguments:

  • USER...: Logins or ids (up to 100). [required]

Options:

  • --date-from TEXT: Window start (ISO 8601); default: now.
  • --date-to TEXT: Window end (ISO 8601); must be after --from.
  • --limit INTEGER RANGE: Max items to fetch (default: the configured cap). [x>=1]
  • --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 or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.

ycli tracker gaps delete

Delete absences by id (DELETE /gaps?gapIds=…); unknown ids are ignored.

Usage:

$ ycli tracker gaps delete [OPTIONS] GAP_ID...

Arguments:

  • GAP_ID...: Absence ids to delete (up to 100). [required]

Options:

  • -o, --format [auto|json|yaml|pretty|csv|markdown|ndjson|name]: Output format (auto = pretty on a TTY, JSON when piped).
  • -y, --yes: Do not ask before an operation that deletes data or grants access.
  • --dry-run: Do not send a write: print the request it would send instead. Reads still run, and only the first write of a command is shown. A secret in the body (a password, a token) is printed as ***.
  • --profile NAME: Use the credentials saved as this profile (YCLI_PROFILE); the environment's and .env's are then not read. ycli auth profiles lists them.
  • -F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the shell history. Write that file with no line break at its end (printf %s 'secret' > file), or the break goes out with the secret.
  • --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.
  • --help: Show this message and exit.