ESC
Type to search...

TeamsTab.Read.All

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Read All Resources

Read the names and settings of tabs inside any team in Microsoft Teams, without a signed-in user. This does not give access to the content inside the tabs.

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

Permission Details

Application Permission

Read tabs in Microsoft Teams.

Read the names and settings of tabs inside any team in Microsoft Teams, without a signed-in user. This does not give access to the content inside the tabs.

Delegated Permission Admin consent required

Read tabs in Microsoft Teams.

Read the names and settings of tabs inside any team in Microsoft Teams, on behalf of the signed-in user. This does not give access to the content inside the tabs.

Properties

Microsoft Graph v1.0 exact-category-docs

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

Property Type Description
configuration teamsTabConfiguration Container for custom settings applied to a tab. The tab is considered configured only once this property is set.
displayName stringNullable Name of the tab.
id string Identifier that uniquely identifies a specific instance of a channel tab. Read-only.
webUrl stringNullable Deep link URL of the tab instance. Read-only.
teamsApp object The application that is linked to the tab. This can't be changed after tab creation.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

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

JSON representation
{
  "id": "string",
  "displayName": "string",
  "webUrl": "string",
  "configuration": "teamsTabConfiguration"
}

Relationships

Microsoft Graph v1.0 exact-category-docs

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

Relationship Type Description
teamsApp teamsApp The application that is linked to the tab. This can't be changed after tab creation.

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 /chats/{chat-id}/tabs
GET /chats/{chat-id}/tabs/{tab-id}
GET /teams/{id}/channels/{id}/tabs
GET /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
Exact Microsoft Learn match

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

Methods
GET /chats/{chat-id}/tabs
GET /chats/{chat-id}/tabs/{tab-id}
GET /teams/{team-id}/channels/{channel-id}/tabs
GET /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgChatTab /chats/{chat-id}/tabs
List tabs in chat
Get-MgChatTab /chats/{chat-id}/tabs/{tab-id}
Get tab in chat
Get-MgTeamChannelTab /teams/{id}/channels/{id}/tabs
List tabs in channel
Get-MgTeamChannelTab /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
Get tab in channel
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgBetaChatTab /chats/{chat-id}/tabs
List tabs in chat
Get-MgBetaChatTab /chats/{chat-id}/tabs/{tab-id}
Get tab in chat
Get-MgBetaTeamChannelTab /teams/{team-id}/channels/{channel-id}/tabs
List tabs in channel

Code Examples

C# / .NET SDK
Get tab in channel
// 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}"].Tabs["{teamsTab-id}"].GetAsync((requestConfiguration) =>
{
	requestConfiguration.QueryParameters.Expand = new string []{ "teamsApp" };
});
JavaScript
Get tab in channel
const options = {
	authProvider,
};

const client = Client.init(options);

let teamsTab = await client.api('/teams/{id}/channels/{id}/tabs/{id}')
	.expand('teamsApp')
	.get();
PowerShell
Get tab in channel
Import-Module Microsoft.Graph.Teams

Get-MgTeamChannelTab -TeamId $teamId -ChannelId $channelId -TeamsTabId $teamsTabId -ExpandProperty "teamsApp"
Python
Get tab in channel
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.teams.item.channels.item.tabs.item.teams_tab_item_request_builder import TeamsTabItemRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = TeamsTabItemRequestBuilder.TeamsTabItemRequestBuilderGetQueryParameters(
		expand = ["teamsApp"],
)

request_configuration = RequestConfiguration(
query_parameters = query_params,
)

result = await graph_client.teams.by_team_id('team-id').channels.by_channel_id('channel-id').tabs.by_teams_tab_id('teamsTab-id').get(request_configuration = request_configuration)

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 TeamsTab.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.