Chat.ManageDeletion.All | Graph Permissions

Permission Details

Application Permission

Delete and recover deleted chats

Allows the app to delete and recover deleted chats, without a signed-in user.

Permission ID: 9c7abde0-eacd-4319-bf9e-35994b1a1717

Delegated Permission

Delete and recover deleted chats

Allows the app to delete and recover deleted chats, on behalf of the signed-in user.

Permission ID: bb64e6fc-6b6d-4752-aea0-dd922dbba588

Properties

Microsoft Graph v1.0 exact-category-docs

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

Property	Type	Description
`chatType`	`chatType`	Specifies the type of chat. The possible values are: group, oneOnOne, meeting, unknownFutureValue.
`createdDateTime`	`dateTimeOffset`Nullable	Date and time at which the chat was created. Read-only.
`id`	`String`	The chat's unique identifier. Read-only.
`isHiddenForAllMembers`	`Boolean`Nullable	Indicates whether the chat is hidden for all its members. Read-only.
`lastUpdatedDateTime`	`dateTimeOffset`Nullable	Date and time at which the chat was renamed or the list of members was last changed. Read-only.
`onlineMeetingInfo`	`teamworkOnlineMeetingInfo`	Represents details about an online meeting. If the chat isn't associated with an online meeting, the property is empty. Read-only.
`tenantId`	`String`Nullable	The identifier of the tenant in which the chat was created. Read-only.
`topic`	`String`Nullable	(Optional) Subject or topic for the chat. Only available for group chats.
`viewpoint`	`chatViewpoint`	Represents caller-specific information about the chat, such as the last message read date and time. This property is populated only when the request is made in a delegated context.
`webUrl`	`String`Nullable	The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. Read-only.
`installedApps`	`teamsAppInstallation collection`	A collection of all the apps in the chat. Nullable.
`lastMessagePreview`	`object`	Preview of the last message sent in the chat. Null if no messages were sent in the chat. Currently, only the list chats operation supports this property.
`members`	`conversationMember collection`	A collection of all the members in the chat. Nullable.
`messages`	`chatMessage collection`	A collection of all the messages in the chat. Nullable.
`permissionGrants`	`resourceSpecificPermissionGrant collection`	A collection of permissions granted to apps for the chat.

Showing 15 of 17 properties.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

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

JSON representation

{
  "createdDateTime": "dateTimeOffset",
  "chatType": "string",
  "id": "string (identifier)",  
  "isHiddenForAllMembers": "Boolean",
  "lastUpdatedDateTime": "dateTimeOffset",
  "onlineMeetingInfo": {
    "@odata.type": "microsoft.graph.teamworkOnlineMeetingInfo"
  },
  "tenantId": "string",
  "topic": "string",
  
  "viewpoint": {
    "@odata.type": "microsoft.graph.chatViewpoint"
  },
  "webUrl": "string",
}

Relationships

Microsoft Graph v1.0 exact-category-docs

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

Relationship	Type	Description
`installedApps`	`teamsAppInstallation collection`	A collection of all the apps in the chat. Nullable.
`lastMessagePreview`	`chatMessageInfo`	Preview of the last message sent in the chat. Null if no messages were sent in the chat. Currently, only the list chats operation supports this property.
`members`	`conversationMember collection`	A collection of all the members in the chat. Nullable.
`messages`	`chatMessage collection`	A collection of all the messages in the chat. Nullable.
`permissionGrants`	`resourceSpecificPermissionGrant collection`	A collection of permissions granted to apps for the chat.
`pinnedMessages`	`pinnedChatMessageInfo collection`	A collection of all the pinned messages in the chat. Nullable.
`tabs`	`teamsTab collection`	A collection of all the tabs in the chat. Nullable.
`chatType`	`chatType`	Related chatType data exposed by this resource.
`operations`	`teamsAsyncOperation collection`	A collection of all the Teams async operations that ran or are running on the chat. Nullable.

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 `/teamwork/deletedChats/{deleted-chat-id}`
POST `/teamwork/deletedChats/{deletedChatId}/undoDelete`
DELETE `/chats/{chat-id}`

Exact Microsoft Learn match

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

Methods
GET `/teamwork/deletedChats/{deleted-chat-id}`
POST `/teamwork/deletedChats/{deletedChatId}/undoDelete`
DELETE `/chats/{chat-id}`

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgTeamworkDeletedChat` /teamwork/deletedChats/{deleted-chat-id} Get deletedChat
`Remove-MgChat` /chats/{chat-id} Delete chat

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgBetaTeamworkDeletedChat` /teamwork/deletedChats/{deleted-chat-id} Get deletedChat
`Remove-MgBetaChat` /chats/{chat-id} Delete chat

Code Examples

C# / .NET SDK

Delete chat

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.Chats["{chat-id}"].DeleteAsync();

JavaScript

Delete chat

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/chats/19:7d898072-792c-4006-bb10-5ca9f2590649_8ea0e38b-efb3-4757-924a-5f94061cf8c2@unq.gbl.spaces')
	.delete();

PowerShell

Delete chat

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Teams

Remove-MgChat -ChatId $chatId

Python

Delete chat

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.chats.by_chat_id('chat-id').delete()

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 Chat.ManageDeletion.All

4

Grant Admin Consent

Application permissions always require admin consent.