Update a section

A specific, existing section can be updated by making a PUT request on
the URL for that project. Only the fields provided in the data block
will be updated; any unspecified fields will remain unchanged. (note that
at this time, the only field that can be updated is the name field.)

When using this method, it is best to specify only those fields you wish
to change, or else you may overwrite changes made by another user since
you last retrieved the task.

Returns the complete updated section record.

curl --location --request PUT 'https://app.asana.com/api/1.0/sections/' \ --header 'Content-Type: application/json' \ --data-raw '{ "data": { "insert_after": "987654", "insert_before": "86420", "name": "Next Actions", "project": "13579" } }'

{ "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

Body Params application/json

data

object (SectionRequest)

optional

insert_after

string

optional

An existing section within this project after which the added section should be inserted. Cannot be provided together with insert_before.

Example:

987654

insert_before

string

optional

An existing section within this project before which the added section should be inserted. Cannot be provided together with insert_after.

Example:

86420

name

string

required

The text to be displayed as the section name. This cannot be an empty string.

Example:

Next Actions

project

string

required

Create-Only The project to create the section in

Example:

13579

Examples

Responses

🟢200Successfully updated the specified 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