TeamworkTag.Read

Allows the app to read 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.Read 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	-	57587d0b-8399-45be-b207-8050cec54575
DisplayText	-	Read tags in Teams
Description	-	Allows the app to read 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
	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}

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.