Sections
Sections are the columns of a board or the groupings of a list view. They belong to a project.
cyber-asana section list --project <project-gid>cyber-asana section get <gid>cyber-asana section create "In Review" --project <project-gid>cyber-asana section create "In Review" --project <project-gid> --insert-after <section-gid>cyber-asana section update <gid> --name "In QA"cyber-asana section move <gid> --project <project-gid> --insert-after <section-gid>cyber-asana section task add <section-gid> <task-gid>cyber-asana section delete <gid>| Command | Arguments | Options |
|---|---|---|
list |
— | --project-gid <gid> / --project <gid>, pagination |
get |
<gid> |
— |
create |
<name> |
--project-gid <gid> / --project <gid>, --insert-before <gid>, --insert-after <gid> |
update |
<gid> |
--name <name> (required) |
move |
<gid> |
--project-gid <gid> / --project <gid>, --insert-before <gid>, --insert-after <gid> |
task add |
<section-gid> <task-gid> |
--insert-before <gid>, --insert-after <gid> |
delete |
<gid> |
— |
Placing a new column
Section titled “Placing a new column”section create takes the same placement flags as section move, so a new column can
land in the right place in one call instead of a create followed by a move. They are
mutually exclusive, and omitting both leaves Asana’s default position:
cyber-asana section create "In Review" --project <project-gid> --insert-after <section-gid>cyber-asana section create "In Review" --project <project-gid> --insert-before <section-gid>Reordering columns
Section titled “Reordering columns”section move places a section relative to another section in the same project.
Exactly one of --insert-before / --insert-after is required — they are mutually
exclusive, and the Asana API needs one of them to know where the section lands.
Sections cannot move between projects.
cyber-asana section move <gid> --project <project-gid> --insert-after <other-section-gid>Putting a task in a section
Section titled “Putting a task in a section”section task add places a task directly into a section — the section-scoped route,
for when you are thinking in board columns:
cyber-asana section task add <section-gid> <task-gid>cyber-asana section task add <section-gid> <task-gid> --insert-before <other-task-gid>The task is removed from any other section of the same project, and lands at the top of
the section unless --insert-before / --insert-after says otherwise (again, mutually
exclusive).
The same placement is reachable from the task side, when you are adding project membership and a position in one call:
cyber-asana task project add <task-gid> <project-gid> --section <section-gid>