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.
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). |
{
"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. |
projects | [object] | Deprecated - please use project instead |
{} .gid | string | Globally unique identifier of the resource, as a string. |
{} .resource_type | string | The base type of this resource. |
{} .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. |
{
"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"
}
]
}