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

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`name`	string	The name of the section (i.e. the text displayed as the section header).

Example JSON for SectionCompact:

{
  "gid": "12345",
  "resource_type": "section",
  "name": "Next Actions"
}

Section

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`name`	string	The name of the section (i.e. the text displayed as the section header).
`created_at`	string (date-time)	The time at which this resource was created.
`project`	object	A 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.gid`	string	Globally unique identifier of the resource, as a string.
`project.resource_type`	string	The base type of this resource.
`project.name`	string	Name 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.
`project.resource_subtype`	string	The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning. Click to show all enum values `custom` `default_project`
`projects[]`	[object]	Deprecated - please use project instead
`projects[].gid`	string	Globally unique identifier of the resource, as a string.
`projects[].resource_type`	string	The base type of this resource.
`projects[].name`	string	Name 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[].resource_subtype`	string	The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning. Click to show all enum values `custom` `default_project`

Example JSON for Section:

{
  "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",
    "resource_subtype": "default_project"
  },
  "projects": [
    {
      "gid": "12345",
      "resource_type": "project",
      "name": "Stuff to buy",
      "resource_subtype": "default_project"
    }
  ]
}