Chat.ManageDeletion.All

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

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the Chat.ManageDeletion.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	9c7abde0-eacd-4319-bf9e-35994b1a1717	bb64e6fc-6b6d-4752-aea0-dd922dbba588
DisplayText	Delete and recover deleted chats	Delete and recover deleted chats
Description	Allows the app to delete and recover deleted chats, without a signed-in user.	Allows the app to delete and recover deleted chats, on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

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

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

• chat
• deletedChat

Graph reference: chat

Property	Type	Description
chatType	chatType	Specifies the type of chat. Possible values are: group, oneOnOne, meeting, unknownFutureValue.
createdDateTime	dateTimeOffset	Date and time at which the chat was created. Read-only.
id	String	The chat's unique identifier. Read-only.
isHiddenForAllMembers	Boolean	Indicates whether the chat is hidden for all its members. Read-only.
lastUpdatedDateTime	dateTimeOffset	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	The identifier of the tenant in which the chat was created. Read-only.
topic	String	(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	The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. Read-only.