Update a team

Updates a team within the current workspace.

Path Params
string
required

Globally unique identifier for the team.

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 team to update.

object

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

Responses

Response body
object
object

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

string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

The name of the team.

string

Opt In. The description of the team.

string

Opt In. The description of the team with formatting as HTML.

object

The organization/workspace the team belongs to.

string
string

The visibility of the team to users in the same organization

secret request_to_join public

string

Controls who can edit team name and description

all_team_members only_team_admins

string

Controls who can edit team visibility and trash teams

all_team_members only_team_admins

string

Controls who can accept or deny member invites for a given team

all_team_members only_team_admins

string

Controls who can accept or deny guest invites for a given team

all_team_members only_team_admins

string

Controls who can accept or deny join team requests for a Membership by Request team. This field can only be updated when the team's visibility field is request_to_join.

all_team_members only_team_admins

string

Controls who can remove team members

all_team_members only_team_admins

string

Controls who can create and share content with the team

no_restriction only_team_admins

boolean

Whether the team has been endorsed

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.