TeamworkTag.ReadWrite

Allows the app to read and write tags in Teams, on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the TeamworkTag.ReadWrite permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	-	539dabd7-b5b6-4117-b164-d60cd15a8671
DisplayText	-	Read and write tags in Teams
Description	-	Allows the app to read and write tags in Teams, on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /teams/{team-id}/tags/{teamworkTag-id}
	DELETE /teams/{team-id}/tags/{teamworkTag-id}/members/{teamworkTagMember-id}
	GET /teams/{team-id}/tags
	GET /teams/{team-id}/tags/{teamworkTag-id}
	GET /teams/{team-id}/tags/{teamworkTag-id}/members
	GET /teams/{team-id}/tags/{teamworkTag-id}/members/{teamworkTagMember-id}
	PATCH /teams/{team-id}/tags/{teamworkTag-id}
	POST /teams/{team-id}/tags

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

• teamworkTag
• teamworkTagMember

Graph reference: teamworkTag

Property	Type	Description
description	String	The description of the tag as it appears to the user in Microsoft Teams. A teamworkTag can't have more than 200 teamworkTagMembers.
displayName	String	The name of the tag as it appears to the user in Microsoft Teams.
id	String	The unique identifier for the tag. Inherited from entity.
memberCount	Int32	The number of users assigned to the tag.
tagType	teamworkTagType	The type of the tag. Default is standard.
teamId	String	ID of the team in which the tag is defined.