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

Add a tag to a task

Adds a tag to a task. Supply the tag's identifier in tag to create the task-tag relationship, and use the operation with the tasks:write scope.

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

1 body field

The tag relationship to add to the task.

dataobjectoptional

6 status codes
200Returns an empty `data` object after the tag has been added to the task.
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 `tag` is missing or the request is malformed.
errorsarray<object>optional
401Returned when a valid authentication token was not provided with the request.
errorsarray<object>optional
403Returned when the authenticated user does not have access to the task or tag, or lacks the required `tasks:write` scope.
errorsarray<object>optional
404Returned when the request does not identify a known action or the task or tag 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 tag is missing or the request is malformed. A 401 is returned when the authenticated user does not provide a valid authentication token, and a 403 is returned when the authenticated user lacks access or the tasks:write scope. A 404 is returned when the task or tag does not exist, and a 500 indicates a server error.