Back to AsanaAdd A Project To A Task
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.
Input
type: object
properties:
parameters:
type: object
properties:
task_gid:
type: string
description: The task to operate on.
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:
- task_gid
title: Parameters
data:
type: object
properties:
data:
type: object
properties:
project:
description: The project to add the task to.
type: string
example: '13579'
insert_after:
description: >-
A task in the project to insert the task after, or `null` to
insert at the beginning of the list.
type: string
nullable: true
example: '124816'
insert_before:
description: >-
A task in the project to insert the task before, or `null` to
insert at the end of the list.
type: string
nullable: true
example: '432134'
section:
description: >-
A section in the project to insert the task into. The task will be
inserted at the bottom of the section.
type: string
nullable: true
example: '987654'
title: Data
Output
type: object
properties:
data:
type: object