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

Remove followers from a task

Removes specified followers from a task when they are currently following it. Supply user identifiers in data.followers, using me, an email address, or a user gid for each follower, and use the tasks:write scope. The response contains the complete updated task record.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
A comma-separated list of optional task properties to include in the response, including nested properties such as `assignee.name` and `completed_at`.

The followers to remove from the task.

dataobjectoptional
Request data containing the users to remove in the `followers` array.

6 status codes
200Returns the complete updated task record after successfully removing the specified followers.
dataobjectoptional
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 followers.
errorsarray<object>optional
404Returned when the request action or specified task or follower 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.followers 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 followers, 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.