Skip to content

Task

List tasks. –assignee is repeatable and accepts workspace_member_nrns (format: nweb:workspace:member:, obtainable from retask auth whoami or retask workspace member list)

Flags: --project-id, --status, --assignee, --priority

Terminal window
retask task list --assignee nweb:workspace:member:<uuid1> --assignee nweb:workspace:member:<uuid2>

Get a task by ID

Terminal window
retask task get <task-id>

Get a task by key (e.g. ENG-42)

Terminal window
retask task get-by-key ENG-42

Create a task. Requires workspace context (–workspace-id or NWEB_WORKSPACE_ID). –description accepts simple HTML. –parent-task-id makes the task a subtask of that task. –assignee is repeatable and takes workspace_member_nrns (format: nweb:workspace:member:); –reporter takes the same NRN format and defaults to the creator

Flags: --project-id, --title, --description, --priority, --due-at, --parent-task-id, --assignee, --reporter, --estimation-points

Terminal window
retask task create --project-id <id> --title 'Fix bug' --priority HIGH --parent-task-id <parent-task-id>

Partial update a task (only set flags change). –status takes a status ID and –task-type a task type ID, both of which must exist in the project’s config. –assignee is repeatable and replaces all assignees (workspace_member_nrns, format: nweb:workspace:member:); pass it empty to clear. –parent-task-id and –reporter accept an empty string to clear

Flags: --title, --description, --priority, --status, --task-type, --assignee, --parent-task-id, --reporter, --estimation-points, --due-at

Terminal window
retask task update <id> --status <status-id> --priority HIGH

Delete a task

Terminal window
retask task delete <task-id>

Attach a file to a task

Terminal window
retask task attachment add <task-id> <file-id>

Remove a file attachment from a task

Terminal window
retask task attachment remove <task-id> <file-id>