TeamworkTag.Read.All

Allows the app to read 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.Read.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	b74fd6c4-4bde-488e-9695-eeb100e4907f	-
DisplayText	Read tags in Teams	-
Description	Allows the app to read 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
	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.

• teamworkChannelTag
• teamworkTag
• teamworkTagMember

Graph reference: teamworkChannelTag

Property	Type	Description
channelId	String	The identifier of the channel that owns the tag. Read-only.
description	String	The description of the tag as it appears in Microsoft Teams. Inherited from teamworkTag.
displayName	String	The name of the tag as it appears in Microsoft Teams. The maximum length is 40 characters. Supports $filter (eq). Inherited from teamworkTag.
id	String	The identifier of the tag. Read-only. Inherited from teamworkTag.
memberCount	Int32	The number of users assigned to the tag. Read-only. Inherited from teamworkTag.
tagType	teamworkTagType	The type of tag. Supports a subset of the members of the teamworkTagType enumeration. Channel tags support only the standard member. Inherited from teamworkTag.
teamId	String	The identifier of the team that hosts the owning channel. Read-only. Inherited from teamworkTag.