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

Unlink dependencies from a task

Removes the specified tasks from a task's dependencies. Supply the dependencies array with the task identifiers to unlink, and use the operation with the tasks:write scope.

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

1 body field

The dependency removal payload containing task identifiers to unlink.

dataobjectoptional

7 status codes
200Returns an empty `data` object after the specified dependencies have been unlinked.
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.