Teams

A team is used to group related projects and people together within an organization. Each project in an organization is associated with a team.

Teams have the following fields:

Field Description
id 1234 Read-only. Globally unique ID of the team.
name 'Engineering' The name of the team.

GET TEAMS IN ORGANIZATION

GET    /teams/team-id

Returns the full record for a single team.

Parameter Description
team 14916 Required: Globally unique identifier for the team.

GET    /organizations/organization-id/teams

Returns the compact records for all teams in the organization visible to the authorized user.

Parameter Description
organization 1331 Required: Globally unique identifier for the workspace or organization.

GET    /users/user-id/teams

Returns the compact records for all teams to which user is assigned.

Parameter Description
user 14641 me sashimi@asana.com Required: An identifier for the user. Can be one of an email address, the globally unique identifier for the user, or the keyword me to indicate the current user making the request.
organization 1331 The workspace or organization to filter teams on.

GET TEAM MEMBERS

GET    /teams/team-id/users

Returns the compact records for all users that are members of the team.

Parameter Description
team 14916 Required: Globally unique identifier for the team.

POST    /teams/team-id/addUser

The user making this call must be a member of the team in order to add others. The user to add must exist in the same organization as the team in order to be added. The user to add can be referenced by their globally unique user ID or their email address. Returns the full user record for the added user.

Parameter Description
team 14916 Required: Globally unique identifier for the team.
user 14641 me sashimi@asana.com Required: An identifier for the user. Can be one of an email address, the globally unique identifier for the user, or the keyword me to indicate the current user making the request.

POST    /teams/team-id/removeUser

The user to remove can be referenced by their globally unique user ID or their email address. Removes the user from the specified team. Returns an empty data record.

Parameter Description
team 14916 Required: Globally unique identifier for the team.
user 14641 me sashimi@asana.com Required: An identifier for the user. Can be one of an email address, the globally unique identifier for the user, or the keyword me to indicate the current user making the request.