ChannelSettings.Read.All | Graph Permissions

Permission Details

Application Permission

Read the names, descriptions, and settings of all channels

Read all channel names, channel descriptions, and channel settings, without a signed-in user.

Permission ID: c97b873f-f59f-49aa-8a0e-52b32d762124

Delegated Permission

Read the names, descriptions, and settings of channels

Read all channel names, channel descriptions, and channel settings, on behalf of the signed-in user.

Permission ID: 233e0cf1-dd62-48bc-b65b-b38fe87fcf8e

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/{id}/primaryChannel`
GET `/teams/{team-id}/allChannels`
GET `/teams/{team-id}/channels`
GET `/teams/{team-id}/channels/{channel-id}`
GET `/teams/{team-id}/incomingChannels`

Exact Microsoft Learn match

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

Methods
GET `/teams/{id}/primaryChannel`
GET `/teams/{team-id}/allChannels`
GET `/teams/{team-id}/channels`
GET `/teams/{team-id}/channels/{channel-id}`
GET `/teams/{team-id}/incomingChannels`

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgAllTeamChannel` /teams/{team-id}/allChannels List allChannels
`Get-MgTeamChannel` /teams/{team-id}/channels List channels
`Get-MgTeamChannel` /teams/{team-id}/channels/{channel-id} Get channel
`Get-MgTeamIncomingChannel` /teams/{team-id}/incomingChannels List incomingChannels
`Get-MgTeamPrimaryChannel` /teams/{id}/primaryChannel Get primaryChannel

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgBetaAllTeamChannel` /teams/{team-id}/allChannels List allChannels
`Get-MgBetaTeamChannel` /teams/{team-id}/channels List channels
`Get-MgBetaTeamChannel` /teams/{team-id}/channels/{channel-id} Get channel
`Get-MgBetaTeamIncomingChannel` /teams/{team-id}/incomingChannels List incomingChannels
`Get-MgBetaTeamPrimaryChannel` /teams/{id}/primaryChannel Get primaryChannel

Code Examples

C# / .NET SDK

Get channel

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

JavaScript

Get channel

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let channel = await client.api('/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:[email protected]')
	.get();

PowerShell

Get channel

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Teams

Get-MgTeamChannel -TeamId $teamId -ChannelId $channelId

Python

Get channel

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').channels.by_channel_id('channel-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 ChannelSettings.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.