Manage tasks
Usage
asana task
Related commands
asana task comment
Manage task comments
Usage
asana task comment <task-gid> <message>
Examples
asana task comment 1234567890123456 "Looking into this now"
printf 'Line 1\nLine 2\n' | asana task comment 1234567890123456 -
asana task view 1234567890123456
asana task comment 1234567890123456 "Fixed in commit abc123"
asana task done 1234567890123456
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task comment delete
Delete a story/comment
Usage
asana task comment delete <story-gid>
Examples
asana task comment delete 1234567890123456 --confirm
asana task comment delete 1234567890123456 --dry-run
Flags
--confirmConfirm the destructive action without a prompt
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Destructive
This command performs a destructive action and asks for confirmation before acting. Preview it first with --dry-run; outside a dry run it proceeds only after explicit confirmation, and in non-interactive mode (--json, --no-prompt, or no terminal) it requires a confirmation flag instead of blocking.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task comment update
Update a story/comment
Usage
asana task comment update <story-gid> <message>
Examples
asana task comment update 1234567890123456 "Updated message"
echo "New text" | asana task comment update 1234567890123456 -
asana task comment update 1234567890123456 "Test" --dry-run
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task create
Create a new task
Usage
asana task create <title>
Examples
asana task create "Fix login bug" -p "My Project"
asana task create "Review PR" -p "Sprint" --assignee me --due 2024-12-31
asana task create "New feature" -p "My Project" -s "To Do"
asana task create "Test task" -p "My Project" --dry-run
asana task create "Urgent fix" -p "Sprint" --json | jq -r '.task.gid'
asana task view <gid-from-above>
Flags
--assigneeAssignee (me or GID)--dueDue date (YYYY-MM-DD or RFC3339 with timezone)--projectProject name--project-gidProject GID--sectionSection name--section-gidSection GID--workspaceWorkspace name (scopes project lookup)--workspace-gidWorkspace GID (scopes project lookup)
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task delete
Delete a task
Usage
asana task delete <gid>
Examples
asana task delete 1234567890123456 --confirm
asana task delete 1234567890123456 --dry-run
Flags
--confirmConfirm the destructive action without a prompt
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Destructive
This command performs a destructive action and asks for confirmation before acting. Preview it first with --dry-run; outside a dry run it proceeds only after explicit confirmation, and in non-interactive mode (--json, --no-prompt, or no terminal) it requires a confirmation flag instead of blocking.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task dependency
Manage task dependencies (tasks this task depends on)
Usage
asana task dependency
Related commands
asana task dependency add
Add dependencies to a task
Usage
asana task dependency add <gid>
Examples
asana task dependency add 1234567890123456 --depends-on 9876543210987654
asana task dependency add 1234567890123456 --depends-on 111,222,333
asana task comment 1234567890123456 "Blocked by design review"
Flags
--depends-onTask GIDs to add as dependencies (required)
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task dependency list
List dependencies of a task
Usage
asana task dependency list <gid>
Examples
asana task dependency list 1234567890123456
asana task dependency list 1234567890123456 --json
Flags
--limitLimit number of dependencies in output
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task dependency remove
Remove dependencies from a task
Usage
asana task dependency remove <gid>
Examples
asana task dependency remove 1234567890123456 --depends-on 9876543210987654 --confirm
asana task dependency list 1234567890123456
asana task comment 1234567890123456 "Unblocked - dependency resolved"
Flags
--confirmConfirm the destructive action without a prompt--depends-onTask GIDs to remove as dependencies (required)
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Destructive
This command performs a destructive action and asks for confirmation before acting. Preview it first with --dry-run; outside a dry run it proceeds only after explicit confirmation, and in non-interactive mode (--json, --no-prompt, or no terminal) it requires a confirmation flag instead of blocking.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task dependent
Manage task dependents (tasks that depend on this task)
Usage
asana task dependent
Related commands
asana task dependent add
Add dependents to a task
Usage
asana task dependent add <gid>
Examples
asana task dependent add 1234567890123456 --dependent 9876543210987654
asana task dependent add 1234567890123456 --dependent 111,222,333
Flags
--dependentTask GIDs to add as dependents (required)
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task dependent list
List dependents of a task
Usage
asana task dependent list <gid>
Examples
asana task dependent list 1234567890123456
asana task dependent list 1234567890123456 --json
Flags
--limitLimit number of dependents in output
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task dependent remove
Remove dependents from a task
Usage
asana task dependent remove <gid>
Examples
asana task dependent remove 1234567890123456 --dependent 9876543210987654 --confirm
Flags
--confirmConfirm the destructive action without a prompt--dependentTask GIDs to remove as dependents (required)
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Destructive
This command performs a destructive action and asks for confirmation before acting. Preview it first with --dry-run; outside a dry run it proceeds only after explicit confirmation, and in non-interactive mode (--json, --no-prompt, or no terminal) it requires a confirmation flag instead of blocking.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task done
Mark task as complete
Usage
asana task done <gid>
Examples
asana task done 1234567890123456
asana task done 1234567890123456 --dry-run
asana task comment 1234567890123456 "Completed - deployed to staging"
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task duplicate
Duplicate a task
Usage
asana task duplicate <gid>
Examples
asana task duplicate 1234567890123456
asana task duplicate 1234567890123456 --name "Copy of Task"
asana task duplicate 1234567890123456 --include assignee,dates,notes,subtasks
asana task duplicate 1234567890123456 --wait
asana task duplicate 1234567890123456 --name "Sprint 2 version" --wait
asana task update <new-gid> --assignee me --due 2024-03-01
Flags
--includeFields to include: assignee, attachments, dates, dependencies, followers, notes, parent, projects, subtasks, tags--nameName for the duplicated task--waitWait for job completion
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task follower
Manage task followers
Usage
asana task follower
Related commands
asana task follower add
Add followers to task
Usage
asana task follower add <gid>
Examples
asana task follower add 1234567890123456 --user me
asana task follower add 1234567890123456 --user [email protected] -w "My Workspace"
asana task follower add 1234567890123456 --user me --user 9876543210987654
asana task create "New feature" -p "Sprint"
asana task follower add <new-gid> --user me --user [email protected]
Flags
--userUser(s) to add (me, GID, or email)--workspaceWorkspace name (for email resolution)--workspace-gidWorkspace GID
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task follower remove
Remove followers from task
Usage
asana task follower remove <gid>
Examples
asana task follower remove 1234567890123456 --user 9876543210987654 --confirm
asana task follower remove 1234567890123456 --user me --dry-run
Flags
--confirmConfirm the destructive action without a prompt--userUser(s) to remove (me, GID, or email)--workspaceWorkspace name (for email resolution)--workspace-gidWorkspace GID
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Destructive
This command performs a destructive action and asks for confirmation before acting. Preview it first with --dry-run; outside a dry run it proceeds only after explicit confirmation, and in non-interactive mode (--json, --no-prompt, or no terminal) it requires a confirmation flag instead of blocking.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task list
List tasks in a project or section
Usage
asana task list
Examples
asana task list -p "My Project"
asana task list -p "My Project" -s "In Progress"
asana task list -p "My Project" --assignee me
asana task list -p "My Project" --json
asana task list -p "My Project" --limit 10
asana task list -p "Sprint" --assignee me
asana task view 1234567890123456
asana task move 1234567890123456 -s "Done"
Flags
--assigneeFilter by assignee (any, me, or GID)--limitLimit number of tasks in output--projectProject name--project-gidProject GID--sectionSection name--section-gidSection GID--workspaceWorkspace name (scopes project lookup)--workspace-gidWorkspace GID (scopes project lookup)
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task move
Move task to a section
Usage
asana task move <gid>
Examples
asana task move 1234567890123456 -s "In Progress"
asana task move 1234567890123456 --section-gid 9876543210987654
asana task move 1234567890123456 -s "Done" --dry-run
asana section list -p "Sprint" # See available sections
asana task move 1234567890123456 -s "Review"
Flags
--projectProject name (required if task has multiple projects)--project-gidProject GID--sectionTarget section name--section-gidTarget section GID
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task parent
Manage task parent
Usage
asana task parent
Related commands
asana task parent set
Set or change task parent
Usage
asana task parent set <gid>
Examples
asana task parent set 1234567890123456 --parent 9876543210987654
asana task parent set 1234567890123456 --parent 9876543210987654 --insert-after 5555555555555555
asana task parent set 1234567890123456 --parent 9876543210987654 --dry-run
Flags
--insert-afterInsert after this sibling task GID--insert-beforeInsert before this sibling task GID--parentNew parent task GID (required)
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task project
Manage task project membership
Usage
asana task project
Related commands
asana task project add
Add task to a project
Usage
asana task project add <gid>
Examples
asana task project add 1234567890123456 -p "My Project"
asana task project add 1234567890123456 -p "My Project" -s "In Progress"
asana task project add 1234567890123456 -p "Sprint 1"
asana task project add 1234567890123456 -p "Q1 Goals"
Flags
--insert-afterInsert after this task GID--insert-beforeInsert before this task GID--projectProject name--project-gidProject GID--sectionSection name within project--section-gidSection GID--workspaceWorkspace name (for project/section name resolution)--workspace-gidWorkspace GID
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task project remove
Remove task from a project
Usage
asana task project remove <gid>
Examples
asana task project remove 1234567890123456 -p "My Project" --confirm
asana task project remove 1234567890123456 -p "My Project" --dry-run
Flags
--confirmConfirm the destructive action without a prompt--projectProject name--project-gidProject GID--workspaceWorkspace name (for project name resolution)--workspace-gidWorkspace GID
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Destructive
This command performs a destructive action and asks for confirmation before acting. Preview it first with --dry-run; outside a dry run it proceeds only after explicit confirmation, and in non-interactive mode (--json, --no-prompt, or no terminal) it requires a confirmation flag instead of blocking.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task reopen
Mark task as incomplete
Usage
asana task reopen <gid>
Examples
asana task reopen 1234567890123456
asana task reopen 1234567890123456 --dry-run
asana task move 1234567890123456 -s "In Progress"
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task search
Search tasks in a workspace (premium feature)
Usage
asana task search
Examples
asana task search -w "My Workspace" --text "login bug"
asana task search -w "My Workspace" --assignee me --completed false
asana task search -w "My Workspace" --due-before 2024-12-31
asana task search -w "My Workspace" -p "Sprint 1"
asana task search -w "My Workspace" --assignee me --text "urgent" --limit 10
asana task search -w "My Workspace" --assignee me --due-before 2024-01-01
asana task update <gid> --due 2024-02-01
Flags
--assigneeFilter by assignee (me, GID, or email)--completedFilter by completion status (true or false)--due-afterTasks due after date (YYYY-MM-DD)--due-beforeTasks due before date (YYYY-MM-DD)--limitMaximum results (capped at 100 by API)--projectFilter by project name--project-gidFilter by project GID--textSearch text--workspaceWorkspace name (required)--workspace-gidWorkspace GID
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task subtask
Manage subtasks
Usage
asana task subtask
Related commands
asana task subtask create
Create a subtask
Usage
asana task subtask create <parent-gid> <title>
Examples
asana task subtask create 1234567890123456 "Review code"
asana task subtask create 1234567890123456 "Write tests" --assignee me --due 2024-12-31
asana task subtask create 1234567890123456 "New subtask" --dry-run
asana task subtask create 1234567890123456 "Design" --assignee me
asana task subtask create 1234567890123456 "Implement" --assignee me
asana task subtask create 1234567890123456 "Test" --assignee me
Flags
--assigneeAssignee (me, GID, or email)--dueDue date (YYYY-MM-DD or RFC3339 with timezone)
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task subtask list
List subtasks of a task
Usage
asana task subtask list <parent-gid>
Examples
asana task subtask list 1234567890123456
asana task subtask list 1234567890123456 --limit 5
asana task subtask list 1234567890123456 --json
Flags
--limitLimit number of subtasks in output
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task tag
Manage task tags
Usage
asana task tag
Related commands
asana task tag add
Add tag to task
Usage
asana task tag add <gid>
Examples
asana task tag add 1234567890123456 --tag "urgent" -w "My Workspace"
asana task tag add 1234567890123456 --tag-gid 9876543210987654
asana task tag add 1234567890123456 --tag "bug" -w "My Workspace"
Flags
--tagTag name--tag-gidTag GID--workspaceWorkspace name (for tag name resolution)--workspace-gidWorkspace GID
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task tag remove
Remove tag from task
Usage
asana task tag remove <gid>
Examples
asana task tag remove 1234567890123456 --tag "urgent" -w "My Workspace" --confirm
asana task tag remove 1234567890123456 --tag "urgent" -w "My Workspace" --dry-run
Flags
--confirmConfirm the destructive action without a prompt--tagTag name--tag-gidTag GID--workspaceWorkspace name (for tag name resolution)--workspace-gidWorkspace GID
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Destructive
This command performs a destructive action and asks for confirmation before acting. Preview it first with --dry-run; outside a dry run it proceeds only after explicit confirmation, and in non-interactive mode (--json, --no-prompt, or no terminal) it requires a confirmation flag instead of blocking.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task update
Update task fields
Usage
asana task update <gid>
Examples
asana task update 1234567890123456 --name "Updated title"
asana task update 1234567890123456 --due 2024-12-31 --assignee me
asana task update 1234567890123456 --clear-due
asana task update 1234567890123456 --notes "New description"
asana task update 1234567890123456 --name "New name" --dry-run
asana task update 1234567890123456 --assignee me --due 2024-12-31
asana task comment 1234567890123456 "Taking over this task"
Flags
--assigneeAssignee (me, GID, or email)--clear-assigneeClear assignee--clear-dueClear due date--clear-notesClear notes--dueDue date (YYYY-MM-DD or RFC3339 with timezone)--nameNew task name--notesNew task notes
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Changes state
This command changes state and honors --dry-run.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.
Related commands
asana task view
View task details
Usage
asana task view <gid>
Examples
asana task view 1234567890123456
asana task view 1234567890123456 --comments-limit 20
asana task view 1234567890123456 --json
Flags
--comments-limitLimit number of comments to show
Output modes
human, json, plain, jq, template
Authentication
This command requires a credential.
Metadata
This command can attach request metadata. In advanced-output apps, add --include-meta to a supported machine output mode to wrap the result as {data, meta}.