Add a project to a task

POST

/tasks/{task_gid}/addProject

Adds the task to the specified project, in the optional location
specified. If no location arguments are given, the task will be added to
the end of the project.

addProject can also be used to reorder a task within a project or
section that already contains it.

At most one of insert_before, insert_after, or section should be
specified. Inserting into a section in an non-order-dependent way can be
done by specifying section, otherwise, to insert within a section in a
particular place, specify insert_before or insert_after and a task
within the section to anchor the position of this task.

Returns an empty data block.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.asana.com/api/1.0/tasks//addProject' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "insert_after": "124816",
        "insert_before": "432134",
        "project": "13579",
        "section": "987654"
    }
}'

Response Example

200 - Example 1

{
    "data": {}
}

Request

Path Params

task_gid

string

required

Body Params application/json

data

object (TaskAddProjectRequest)

optional

insert_after

string | null

optional

A task in the project to insert the task after, or null to insert at the beginning of the list.

Example:

124816

insert_before

string | null

optional

A task in the project to insert the task before, or null to insert at the end of the list.

Example:

432134

project

string

required

The project to add the task to.

Example:

13579

section

string | null

optional

A section in the project to insert the task into. The task will be inserted at the bottom of the section.

Example:

987654

Examples

Responses

🟢200Successfully added the specified project to 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:32

Add followers to a task

Add a tag to a task