Add task to section

Add a task to a specific, existing section. This will remove the task from other sections of the project.

The task will be inserted at the top of a section unless an insert_before or insert_after parameter is declared.

This does not work for separators (tasks with the resource_subtype of section).

curl --location --request POST 'https://app.asana.com/api/1.0/sections//addTask' \ --header 'Content-Type: application/json' \ --data-raw '{ "data": { "insert_after": "987654", "insert_before": "86420", "task": "123456" } }'

Request

Path Params

section_gid

string

required

Body Params application/json

data

object (SectionTaskInsertRequest)

optional

insert_after

string

optional

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

Example:

987654

insert_before

string

optional

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

Example:

86420

task

string

required

The task to add to this section.

Example:

123456

Examples

Responses

🟢200Successfully added the task.

application/json

Body

data

object (EmptyResponse)

optional

An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500