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"
    }
  ]
}