[ Change ] Ability to edit team administrative settings

English Forum Developers & API Changelog
1

Summary

The teams API can now be used to configure administrative and endorsement settings on teams. Previously, team administrative settings fields were read-only, and the team endorsement state was not accessible through the API. This update introduces new capabilities for developers:

New boolean field (read and write access)

  • endorsed

This field allows you to set whether a team is endorsed. To modify this field, the user must possess sufficient permissions. Endorsement capabilities are restricted to Admins, Super Admins, and Service Accounts and are available only in Asana’s Enterprise tiers.

Writeable string fields (previously read-only)

These fields have been transitioned from read-only to writable, allowing for greater control over team management:

  • edit_team_name_or_description_access_level
  • member_invite_management_access_level
  • guest_invite_management_access_level
  • join_request_management_access_level
  • team_member_removal_access_level

Modifying these fields requires the user to have adequate permissions. This capability is available to Team Admins, Admins, Super Admins, and Service Accounts across all paid Asana tiers.

Who is affected

Existing applications and integrations will not experience any change due to this update. However, developers now have the option to enhance their solutions using these newly available fields.

Why we’re making this change

This change improves the ability for customers and third party developers to manage the behaviors of teams in Asana bringing the API in line with the capabilities in the web app.

Timeline

This change is effective immediately.

Usage

To take advantage of these new settings, developers can use the following API endpoints:

{
  "data": {
	"name": "{{teamName}}",
	"organization": "{{domainId}}",
	"edit_team_name_or_description_access_level": "only_team_admins",
	"member_invite_management_access_level": "only_team_admins",
	"guest_invite_management_access_level": "only_team_admins",
	"join_request_management_access_level": "only_team_admins",
	"team_member_removal_access_level": "only_team_admins",
	"endorsed": "true"
  }
}

Migration steps

No migration is necessary.

Resources

3 Likes