Asana API
Getting access, Developing, Testing
Back to Asana
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).
Input
type: object
properties:
parameters:
type: object
properties:
section_gid:
type: string
description: The globally unique identifier for the section.
opt_pretty:
type: boolean
description: >-
Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this
means doing proper line breaking and indentation to make it readable.
This will take extra time and increase the response size so it is
advisable only to use this during debugging.
opt_fields:
type: array
items:
type: string
description: >-
Defines fields to return.
Some requests return *compact* representations of objects in order to
conserve resources and complete the request more efficiently. Other
times requests return more information than you may need. This option
allows you to list the exact set of fields that the API should be sure
to return for the objects. The field names should be provided as
paths, described below.
The id of included objects will always be returned, regardless of the
field options.
required:
- section_gid
title: Parameters
data:
type: object
properties:
data:
type: object
properties:
task:
description: The task to add to this section.
type: string
example: '123456'
insert_before:
description: >-
An existing task within this section before which the added task
should be inserted. Cannot be provided together with insert_after.
type: string
example: '86420'
insert_after:
description: >-
An existing task within this section after which the added task
should be inserted. Cannot be provided together with
insert_before.
type: string
example: '987654'
title: Data
Output
type: object
properties:
data:
type: object