Asana

Add task to section

POST

/sections/{section_gid}/addTask

Sections

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).

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.asana.com/api/1.0/sections//addTask' \
--header 'Content-Type: application/json' \
--data-raw ''

Response Example

200 - Example 1

{
  "data": {}
}

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

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

Update a section

Get tasks from a project