Get a section

GET

/sections/{section_gid}

Returns the complete record for a single section.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://app.asana.com/api/1.0/sections/'

Response Example

200 - Example 1

{
    "data": {
        "gid": "12345",
        "resource_type": "task",
        "name": "Next Actions",
        "created_at": "2012-02-22T02:06:58.147Z",
        "project": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Stuff to buy"
        },
        "projects": [
            {
                "gid": "12345",
                "resource_type": "task",
                "name": "Stuff to buy"
            }
        ]
    }
}

Request

Path Params

section_gid

string

required

Responses

🟢200Successfully retrieved section.

application/json

Body

data

object (SectionResponse)

optional

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.

created_at

string <date-time>

read-onlyoptional

The time at which this resource was created.

Example:

2012-02-22T02:06:58.147Z

project

object

ProjectCompact

optional

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.

projects

array[object (ProjectCompact) {3}]

read-onlyoptional

Deprecated - please use project instead

gid

string

read-onlyoptional

Globally unique identifier of the resource, as a string.

Example:

12345

resource_type

string

read-onlyoptional

The base type of this resource.

Example:

task

name

string

optional

The name of the section (i.e. the text displayed as the section header).

Example:

Next Actions

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Modified at 2022-09-13 02:00:31

Delete a section

Update a section