Sections

Add task to section

<b>Required scope: </b><code>tasks:write</code>

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

post/sections/{section_gid}/addTask

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/sections/{section_gid}/addTask
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token, scopes: tasks:write)

Request body

Example request

{
  "data": {
    "task": "123456",
    "insert_before": "86420",
    "insert_after": "987654"
  }
}

Response

Successfully added the task.

dataEmptyResponse

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.

Changes

No recorded changes to this operation across all 51 revisions of this API.