Sections

A section is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.

Sections are largely a shared idiom in Asana’s API for both list and board views of a project regardless of the project’s layout.

The memberships property when getting a task will return the information for the section or the column under ‘section’ in the response.


SectionCompact

A Compact object reflects the default fields returned after a successful API request. See input/output options to include more fields in the response.

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
namestringThe name of the section (i.e. , the text displayed as the section header).
{ "gid": "12345", "resource_type": "section", "name": "Next Actions" }

Section

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
namestringThe name of the section (i.e. , the text displayed as the section header).
created_atstring(date-time)The time at which this resource was created.
projectobjectA project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.
project.gidstringGlobally unique identifier of the resource, as a string.
project.resource_typestringThe base type of this resource.
project.namestringName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
projects[object]Deprecated - please use project instead
{}.gidstringGlobally unique identifier of the resource, as a string.
{}.resource_typestringThe base type of this resource.
{}.namestringName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
{ "gid": "12345", "resource_type": "section", "name": "Next Actions", "created_at": "2012-02-22T02:06:58.147Z", "project": { "gid": "12345", "resource_type": "project", "name": "Stuff to buy" }, "projects": [ { "gid": "12345", "resource_type": "project", "name": "Stuff to buy" } ] }
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.