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

Remove a tag from a task

Removes a specified tag from a task. Supply the tag identifier in data.tag and use the tasks:write scope. A successful response contains an empty data object.

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

1 body field

The tag to remove from the task.

dataobjectoptional
Request data containing the `tag` identifier to remove.

6 status codes
200Returns an empty `data` object after successfully removing the specified tag from 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 a required or other request parameter is missing or malformed.
errorsarray<object>optional
401Returned when a valid authentication token was not provided.
errorsarray<object>optional
403Returned when the authenticated user does not have access to the task or tag.
errorsarray<object>optional
404Returned when the request action or specified task or tag does not exist.
errorsarray<object>optional
500Returned when a problem occurs on the server; the response may include an error phrase.
errorsarray<object>optional

Error handling

A 400 is returned when data.tag is missing or malformed, and a 401 is returned when no valid authentication token is provided. A 403 is returned when the authenticated user lacks access to the task or tag, and a 404 is returned when the action or specified object does not exist. A 500 indicates a server-side problem; the request requires the tasks:write scope.