ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

Team.ReadBasic.All

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Read All Resources

Get a list of all teams, without a signed-in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Application Permission

Get a list of all teams

Get a list of all teams, without a signed-in user.

Permission ID: 2280dda6-0bfd-44ee-a2f4-cb867cfc4c1e
Delegated Permission User consent allowed

Read the names and descriptions of teams

Read the names and descriptions of teams, on behalf of the signed-in user.

User sees: Read the names and descriptions of teams, on your behalf.
Permission ID: 485be79e-c497-4b35-9400-0e3fa7f2a5d4

Properties

Microsoft Graph v1.0 exact-category-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 stringNullable 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 dateTimeOffsetNullable Timestamp at which the team was created.
description stringNullable An optional description for the team. Maximum length: 1,024 characters.
displayName stringNullable The name of the team.
firstChannelName StringNullable 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 stringNullable A unique ID for the team that was used in a few places such as the audit log/Office 365 Management Activity API.
isArchived BooleanNullable 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 exact-category-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 exact-category-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 /groups/{id}/photo
GET /groups/{id}/photo/$value
GET /groups/{id}/photos/{size}
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
GET /me/contacts/{id}/photo
GET /me/contacts/{id}/photo/$value
GET /me/joinedTeams
GET /me/photo
GET /me/photo/$value
GET /me/photos
GET /me/photos/{size}
GET /teams
GET /teams/{id}/photo
GET /teams/{id}/photo/$value
GET /teams/{team-id}
GET /teamwork/deletedTeams
GET /users/{id | user-principal-name}/joinedTeams
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/photo
GET /users/{id | userPrincipalName}/photo/$value
GET /users/{id | userPrincipalName}/photos/{size}
GET /users/{user-id}/teamwork/associatedTeams
Exact Microsoft Learn match

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

Methods
GET /groups/{id}/photo
GET /groups/{id}/photo/$value
GET /groups/{id}/photos/{size}
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
GET /me/contacts/{id}/photo
GET /me/contacts/{id}/photo/$value
GET /me/joinedTeams
GET /me/photo
GET /me/photo/$value
GET /me/photos
GET /me/photos/{size}
GET /teams
GET /teams/{id}/photo
GET /teams/{id}/photo/$value
GET /teams/{team-id}
GET /teamwork/deletedTeams
GET /users/{id | user-principal-name}/joinedTeams
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/photo
GET /users/{id | userPrincipalName}/photo/$value
GET /users/{id | userPrincipalName}/photos/{size}
GET /users/{user-id}/teamwork/associatedTeams
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgTeam /teams
List teams
Get-MgTeam /teams/{team-id}
Get team
Get-MgTeamPhoto /me/photo/$value
Get profilePhoto
Get-MgTeamPhotoContent /me/photo/$value
Get profilePhoto
Get-MgTeamworkDeletedTeam /teamwork/deletedTeams
List deletedTeams
Get-MgUserJoinedTeam /me/joinedTeams
List joinedTeams
Get-MgUserPhoto /me/photo/$value
Get profilePhoto
Get-MgUserPhotoContent /me/photo/$value
Get profilePhoto
Get-MgUserTeamworkAssociatedTeam /users/{user-id}/teamwork/associatedTeams
List associatedTeamInfo
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgBetaTeam /teams
List teams
Get-MgBetaTeam /teams/{team-id}
Get team
Get-MgBetaTeamworkDeletedTeam /teamwork/deletedTeams
List deletedTeams
Get-MgBetaUserJoinedTeam /me/joinedTeams
List joinedTeams
Get-MgBetaUserTeamworkAssociatedTeam /users/{user-id}/teamwork/associatedTeams
List associatedTeamInfo

Code Examples

C# / .NET SDK
Get profilePhoto
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
await graphClient.Me.Photo.Content.GetAsync();
JavaScript
Get profilePhoto
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

let stream = await client.api('/me/photo/$value')
	.get();
PowerShell
Get profilePhoto
View official example on Microsoft Learn
Import-Module Microsoft.Graph.Users
# A UPN can also be used as -UserId.
Get-MgUserPhotoContent -UserId $userId -OutFile $outFileId
Python
Get profilePhoto
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

await graph_client.me.photo.content.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 Team.ReadBasic.All

4

Grant Admin Consent

Application permissions always require admin consent.