TeamsTab.ReadWriteSelfForChat.All
Allows a Teams app to read, install, upgrade, and uninstall its own tabs for any chat, without a signed-in user.
Permission Details
Allow the Teams app to manage only its own tabs for all chats
Allows a Teams app to read, install, upgrade, and uninstall its own tabs for any chat, without a signed-in user.
9f62e4a2-a2d6-4350-b28b-d244728c4f86
Properties
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
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"id": "string",
"displayName": "string",
"webUrl": "string",
"configuration": "teamsTabConfiguration"
}Relationships
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
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}
|
POST
/chats/{chat-id}/tabs
|
PATCH
/chats/{chat-id}/tabs/{tab-id}
|
DELETE
/chats/{chat-id}/tabs/{tab-id}
|
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}
|
POST
/chats/{chat-id}/tabs
|
PATCH
/chats/{chat-id}/tabs/{tab-id}
|
DELETE
/chats/{chat-id}/tabs/{tab-id}
|
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
// 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.Chats["{chat-id}"].Tabs["{teamsTab-id}"].DeleteAsync();const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/chats/19:[email protected]/tabs/d731fca0-0f14-4537-971a-0ef9101ff13d')
.delete();Import-Module Microsoft.Graph.Teams
Remove-MgChatTab -ChatId $chatId -TeamsTabId $teamsTabId# 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.chats.by_chat_id('chat-id').tabs.by_teams_tab_id('teamsTab-id').delete()App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions and search for TeamsTab.ReadWriteSelfForChat.All
Grant Admin Consent
Application permissions always require admin consent.