TeamMember.Read.All | Graph Permissions

Permission Details

Application Permission

Read the members of all teams

Read the members of all teams, without a signed-in user.

Permission ID: 660b7406-55f1-41ca-a0ed-0b035e182f3e

Delegated Permission

Read the members of teams

Read the members of teams, on behalf of the signed-in user.

Permission ID: 2497278c-d82d-46a2-b1ce-39d4cdde5570

Properties

Microsoft Graph v1.0 endpoint-derived-docs

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

Property	Type	Description
`id`	`string`	The unique identifier of the team. The group has the same ID as the team. This property is read-only, and is inherited from the base entity type.
`classification`	`string`Nullable	An optional label. Typically describes the data or business sensitivity of the team. Must match one of a preconfigured set in the tenant's directory.
`classSettings`	`teamClassSettings`	Configure settings of a class. Available only when the team represents a class.
`createdDateTime`	`dateTimeOffset`Nullable	Timestamp at which the team was created.
`description`	`string`Nullable	An optional description for the team. Maximum length: 1,024 characters.
`displayName`	`string`Nullable	The name of the team.
`firstChannelName`	`String`Nullable	The name of the first channel in the team. This is an optional property, only used during team creation and isn't returned in methods to get and list teams.
`funSettings`	`teamFunSettings`	Settings to configure use of Giphy, memes, and stickers in the team.
`guestSettings`	`teamGuestSettings`	Settings to configure whether guests can create, update, or delete channels in the team.
`internalId`	`string`Nullable	A unique ID for the team that was used in a few places such as the audit log/Office 365 Management Activity API.
`isArchived`	`Boolean`Nullable	Whether this team is in read-only mode.
`memberSettings`	`teamMemberSettings`	Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team.
`messagingSettings`	`teamMessagingSettings`	Settings to configure messaging and mentions in the team.
`specialization`	`teamSpecialization`	Optional. Indicates whether the team is intended for a particular use case. Each team specialization has access to unique behaviors and experiences targeted to its use case.
`summary`	`teamSummary`	Contains summary information about the team, including number of owners, members, and guests.

Showing 15 of 32 properties.

JSON Representation

Microsoft Graph v1.0 endpoint-derived-docs

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

JSON representation

{
  "classSettings": {
    "@odata.type": "microsoft.graph.teamClassSettings"
  },
  "classification": "String",
  "createdDateTime": "DateTimeOffset",
  "description": "String",
  "displayName": "String",
  "firstChannelName": "String",
  "funSettings": {
    "@odata.type": "microsoft.graph.teamFunSettings"
  },
  "guestSettings": {
    "@odata.type": "microsoft.graph.teamGuestSettings"
  },
  "internalId": "String",
  "isArchived": "Boolean",
  "memberSettings": {
    "@odata.type": "microsoft.graph.teamMemberSettings"
  },
  "messagingSettings": {
    "@odata.type": "microsoft.graph.teamMessagingSettings"
  },
  "specialization": "String",
  "tenantId": "String",
  "visibility": "String",
  "webUrl": "String (URL)"
}

Relationships

Microsoft Graph v1.0 endpoint-derived-docs

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

Relationship	Type	Description
`allChannels`	`channel collection`	List of channels either hosted in or shared with the team (incoming channels).
`channels`	`channel collection`	The collection of channels and messages associated with the team.
`incomingChannels`	`channel collection`	List of channels shared with the team.
`installedApps`	`teamsAppInstallation collection`	The apps installed in this team.
`members`	`conversationMember collection`	Members and owners of the team.
`operations`	`teamsAsyncOperation collection`	The async operations that ran or are running on this team.
`photo`	`profilePhoto`	The profile photo for the team.
`primaryChannel`	`channel`	The general channel for the team.
`schedule`	`schedule`	The schedule of shifts for this team.
`tags`	`teamworkTag collection`	The tags associated with the team.
`template`	`teamsTemplate`	The template this team was created from. See available templates.
`permissionGrants`	`resourceSpecificPermissionGrant collection`	A collection of permissions granted to apps to access the team.
`owners`	`user collection`	The list of this team's owners. Currently, when creating a team using application permissions, exactly one owner must be specified. When using user-delegated permissions, no owner can be specified (the current user is the owner). The owner must be specified as an object ID (GUID), not a UPN.

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}/members`
GET `/teams/{team-id}/members/{membership-id}`

Exact Microsoft Learn match

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

Methods
GET `/teams/{team-id}/members`
GET `/teams/{team-id}/members/{membership-id}`

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgTeamMember` /teams/{team-id}/members List members of team
`Get-MgTeamMember` /teams/{team-id}/members/{membership-id} Get member of team

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgBetaTeamMember` /teams/{team-id}/members List members of team
`Get-MgBetaTeamMember` /teams/{team-id}/members/{membership-id} Get member of team

Code Examples

C# / .NET SDK

Get member of team

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}"].Members["{conversationMember-id}"].GetAsync();

JavaScript

Get member of team

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let conversationMember = await client.api('/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/members/ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=')
	.get();

PowerShell

Get member of team

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Teams

Get-MgTeamMember -TeamId $teamId -ConversationMemberId $conversationMemberId

Python

Get member of team

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').members.by_conversation_member_id('conversationMember-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 or delegated permissions and search for TeamMember.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.