Sample - Asana API
POST/tasks/{task_gid}/addDependencies

Set dependencies for a task

Adds the specified tasks as dependencies of a task without changing dependencies that are already present. Supply the dependencies array with task identifiers, and keep the task's combined dependents and dependencies at no more than 30. The operation requires the tasks:write scope.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 body field

The dependency update payload containing task identifiers to add as dependencies.

dataobjectoptional

7 status codes
200Returns an empty `data` object after the specified dependencies have been set.
dataobjectoptional
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.
400Returned when the request is missing or malformed, including when the dependency list is invalid.
errorsarray<object>optional
401Returned when a valid authentication token was not provided with the request.
errorsarray<object>optional
402Returned when the requested object mutation exceeds the authenticated user's current premium level.
errorsarray<object>optional
403Returned when the authenticated user does not have access to the task or lacks the required `tasks:write` scope.
errorsarray<object>optional
404Returned when the request does not identify a known action or the task or a referenced object does not exist.
errorsarray<object>optional
500Returned when the API encounters a server-side problem; the response may include an error phrase.
errorsarray<object>optional

Error handling

A 400 is returned when the body is missing or malformed, including an invalid dependencies value. A 401 is returned when the authenticated user does not provide a valid authentication token, a 402 when the requested mutation exceeds the current premium level, and a 403 when the authenticated user lacks access or the tasks:write scope. A 404 is returned when the task or a referenced object does not exist, and a 500 indicates a server error.