Remove a collaborator from a goal

Removes followers from a goal. Returns the goal the followers were removed from.
Each goal can be associated with zero or more followers in the system.
Requests to add/remove followers, if successful, will return the complete updated goal record, described above.

Path Params
string
required

Globally unique identifier for the goal.

Query Params
array of strings

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

opt_fields
boolean

Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

Body Params

The followers to be removed as collaborators

object
Responses

Response body
object
object

A generic Asana Resource, containing a globally unique identifier.

string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

The name of the goal.

string

The notes of the goal with formatting as HTML.

string

Free-form textual information associated with the goal (i.e. its description).

string | null

The localized day on which this goal is due. This takes a date with format YYYY-MM-DD.

string | null

The day on which work for this goal begins, or null if the goal has no start date. This takes a date with YYYY-MM-DD format, and cannot be set unless there is an accompanying due date.

boolean

Conditional. This property is only present when the workspace provided is an organization. Whether the goal belongs to the workspace (and is listed as part of the workspace’s goals) or not. If it isn’t a workspace-level goal, it is a team-level goal, and is associated with the goal’s team.

boolean

True if the goal is liked by the authorized user, false if not.

array of objects

Array of likes for users who have liked this goal.

likes
object
string

Globally unique identifier of the object, as a string.

object

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.

integer

The number of users who have liked this goal.

object | null

Conditional. This property is only present when the workspace provided is an organization.

object

A workspace is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.

array of objects

Array of users who are members of this goal.

followers
object
string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

Read-only except when same user as requester. The user’s name.

object | null

A generic Asana Resource, containing a globally unique identifier.

object | null

A generic Asana Resource, containing a globally unique identifier.

object | null

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.

object | null

The latest status_update posted to this goal.

string | null

The current status of this goal. When the goal is open, its status can be green, yellow, and red to reflect "On Track", "At Risk", and "Off Track", respectively. When the goal is closed, the value can be missed, achieved, partial, or dropped.
Note you can only write to this property if metric is set.

Language
Credentials
Request
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.