TeamworkTag.Read.All | Graph Permissions

Permission Details

Application Permission

Read tags in Teams

Allows the app to read tags in Teams without a signed-in user.

Permission ID: b74fd6c4-4bde-488e-9695-eeb100e4907f

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`description`	`String`Nullable	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`Nullable	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`Nullable	The number of users assigned to the tag.
`tagType`	`teamworkTagType`	The type of the tag. Default is standard.
`teamId`	`String`Nullable	ID of the team in which the tag is defined.
`members`	`teamworkTagMember collection`	Users assigned to the tag.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "@odata.type": "#microsoft.graph.teamworkTag",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "memberCount": "Int32",
  "tagType": "String",
  "teamId": "String"
}

Relationships

Microsoft Graph v1.0 exact-category-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`members`	`teamworkTagMember collection`	Users assigned to the tag.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

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}`

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

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}`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgTeamTag` /teams/{team-id}/tags List teamworkTags
`Get-MgTeamTag` /teams/{team-id}/tags/{teamworkTag-id} Get teamworkTag
`Get-MgTeamTagMember` /teams/{team-id}/tags/{teamworkTag-id}/members List teamworkTagMembers
`Get-MgTeamTagMember` /teams/{team-id}/tags/{teamworkTag-id}/members/{teamworkTagMember-id} Get teamworkTagMember

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgBetaTeamTag` /teams/{team-Id}/tags List teamworkTags
`Get-MgBetaTeamTag` /teams/{team-Id}/tags/{teamworkTag-Id} Get teamworkTag
`Get-MgBetaTeamTagMember` /teams/{team-Id}/tags/{teamworkTag-Id}/members List teamworkTagMembers
`Get-MgBetaTeamTagMember` /teams/{team-Id}/tags/{teamworkTag-Id}/members/{teamworkTagMember-Id} Get teamworkTagMember

Code Examples

C# / .NET SDK

Get teamworkTag

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].Tags["{teamworkTag-id}"].GetAsync();

JavaScript

Get teamworkTag

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let teamworkTag = await client.api('/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk==')
	.get();

PowerShell

Get teamworkTag

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Teams

Get-MgTeamTag -TeamId $teamId -TeamworkTagId $teamworkTagId

Python

Get teamworkTag

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.teams.by_team_id('team-id').tags.by_teamwork_tag_id('teamworkTag-id').get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions and search for TeamworkTag.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.