TeamworkTag.ReadWrite.All

Allows the app to read and write tags in Teams without a 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.All 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	a3371ca5-911d-46d6-901c-42c8c7a937d8	-
DisplayText	Read and write tags in Teams	-
Description	Allows the app to read and write tags in Teams without a signed-in user.	-
AdminConsentRequired	-	-

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
	POST /teams/{team-id}/tags/{teamworkTag-id}/members

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.