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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 search¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists 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 profileslists 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 profileslists 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-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 links¶
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...
ycli tracker links list¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 links list-filtered¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 links create¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 links delete¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 links import¶
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-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 (fromtransitions 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 search¶
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-DDThhss.
--created-to TEXT: Range end, YYYY-MM-DDThhss.
-o, --format [auto|json|yaml|pretty|csv|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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.
--created-to TEXT: Range end, YYYY-MM-DDThhss.
-o, --format [auto|json|yaml|pretty|csv|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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.sss±hhmm. [required]
--created-by TEXT: Login or id of the original author. [required]--start TEXT: Work start time, YYYY-MM-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 (fromlocalfields 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 (fromlocalfields 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 (fromfieldscategories). [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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.sss±hhmm).
--date-to TEXT: Range end (YYYY-MM-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 remotelinks¶
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...
ycli tracker remotelinks list¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 remotelinks create¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 remotelinks delete¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.sss±hhmm.
--end TEXT: Deadline date, YYYY-MM-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 search¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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-DDThhss.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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 links¶
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).
ycli tracker entities links list¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 links create¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 links delete¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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); seeworkflows 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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); seeworkflows 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 search¶
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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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 profileslists them.-F, --field TEXT: Set any field of the request body: key=value, key[sub]=value for a nested one (JSON-coerced; repeatable). key=@FILE (@- for stdin) gives the file's text as it is; a string that starts with @ goes in JSON quotes ('text="@ivan"'). A flag of the command wins over it. Objects merge; a list replaces the one below it. Give a secret from a file, not typed here: a command line stays in the 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.