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.


TeamCompact

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
namestringThe name of the team.

Example JSON for TeamCompact:

{
  "gid": "12345",
  "resource_type": "team",
  "name": "Marketing"
}

Team

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
namestringThe name of the team.
descriptionstringOpt In. The description of the team.
html_descriptionstringOpt In. The description of the team with formatting as HTML.
organizationobjectThe organization/workspace the team belongs to.
organization.gidstringGlobally unique identifier of the resource, as a string.
organization.resource_typestringThe base type of this resource.
organization.namestringThe name of the workspace.
permalink_urlstringA url that points directly to the object within Asana.
visibilitystringThe visibility of the team to users in the same organization Values can be: secret, request_to_join, public.
edit_team_name_or_description_access_levelstringControls who can edit team name and description Values can be: all_team_members, only_team_admins.
edit_team_visibility_or_trash_team_access_levelstringControls who can edit team visibility and trash teams Values can be: all_team_members, only_team_admins.
member_invite_management_access_levelstringControls who can accept or deny member invites for a given team Values can be: all_team_members, only_team_admins.
guest_invite_management_access_levelstringControls who can accept or deny guest invites for a given team Values can be: all_team_members, only_team_admins.
join_request_management_access_levelstringControls 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. Values can be: all_team_members, only_team_admins.
team_member_removal_access_levelstringControls who can remove team members Values can be: all_team_members, only_team_admins.
team_content_management_access_levelstringControls who can create and share content with the team Values can be: no_restriction, only_team_admins.
endorsedbooleanWhether the team has been endorsed

Example JSON for Team:

{
  "gid": "12345",
  "resource_type": "team",
  "name": "Marketing",
  "description": "All developers should be members of this team.",
  "html_description": "<body><em>All</em> developers should be members of this team.</body>",
  "organization": {
    "gid": "12345",
    "resource_type": "workspace",
    "name": "My Company Workspace"
  },
  "permalink_url": "https://app.asana.com/0/resource/123456789/list",
  "visibility": "example string",
  "edit_team_name_or_description_access_level": "example string",
  "edit_team_visibility_or_trash_team_access_level": "example string",
  "member_invite_management_access_level": "example string",
  "guest_invite_management_access_level": "example string",
  "join_request_management_access_level": "example string",
  "team_member_removal_access_level": "example string",
  "team_content_management_access_level": "example string",
  "endorsed": false
}
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.