Group-Conversation.ReadWrite.All

Allows the app to read and write group conversations that the signed-in user has access to.

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 Group-Conversation.ReadWrite.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	6679c91b-820a-4900-ab47-e97b197a89c4	302bcbb5-855a-4e49-ae20-94a331b0281e
DisplayText	Read and write all group conversations	Read and write group conversations
Description	Allows the app to read and write conversations of the groups this app has access to without a signed-in user.	Allows the app to read and write group conversations that the signed-in user has access to.
AdminConsentRequired	Yes	Yes

Graph Methods

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

	Methods
	GET /groups/{groupId}/conversations/{conversationId}/threads/{threadId}/posts
	GET /groups/{groupId}/threads/{threadId}/posts
	GET /groups/{id}/conversations
	GET /groups/{id}/conversations/{id}/threads
	GET /groups/{id}/conversations/{id}/threads/{id}
	GET /groups/{id}/conversations/{id}/threads/{id}/posts/{id}
	GET /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/attachments
	GET /groups/{id}/threads
	GET /groups/{id}/threads/{id}
	GET /groups/{id}/threads/{id}/posts/{id}
	GET /groups/{id}/threads/{id}/posts/{id}/attachments
	PATCH /groups/{group id}/conversations/{conversation id}/threads/{thread id}
	PATCH /groups/{group id}/threads/{thread id}
	PATCH /groups/{id}/threads/{id}
	POST /groups/{id}/conversations/{id}/threads
	POST /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/forward
	POST /groups/{id}/threads/{id}/posts/{id}/forward

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

	Methods
	GET /groups/{groupId}/conversations/{conversationId}/threads/{threadId}/posts
	GET /groups/{groupId}/threads/{threadId}/posts
	GET /groups/{id}/conversations
	GET /groups/{id}/conversations/{id}
	GET /groups/{id}/conversations/{id}/threads
	GET /groups/{id}/conversations/{id}/threads/{id}
	GET /groups/{id}/conversations/{id}/threads/{id}/posts/{id}
	GET /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/attachments
	GET /groups/{id}/threads
	GET /groups/{id}/threads/{id}
	GET /groups/{id}/threads/{id}/posts/{id}
	GET /groups/{id}/threads/{id}/posts/{id}/attachments
	PATCH /groups/{group id}/conversations/{conversation id}/threads/{thread id}
	PATCH /groups/{group id}/threads/{thread id}
	PATCH /groups/{id}/threads/{id}
	POST /groups/{id}/conversations/{id}/threads
	POST /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/forward
	POST /groups/{id}/threads/{id}/posts/{id}/forward

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

	Commands
	Get-MgGroupConversation
	Get-MgGroupConversationThread
	Get-MgGroupThread
	Get-MgGroupThreadPost
	Get-MgGroupThreadPostAttachment
	Invoke-MgForwardGroupThreadPost
	New-MgGroupConversationThread
	Update-MgGroupThread

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

	Commands
	Get-MgBetaGroupConversation
	Get-MgBetaGroupConversationThread
	Get-MgBetaGroupThread
	Get-MgBetaGroupThreadPost
	Get-MgBetaGroupThreadPostAttachment
	Invoke-MgBetaForwardGroupThreadPost
	New-MgBetaGroupConversationThread
	Update-MgBetaGroupThread

Resources

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

Graph reference: attachment

Property	Type	Description
contentType	String	The MIME type.
id	String	Read-only.
isInline	Boolean	`true` if the attachment is an inline attachment; otherwise, `false`.
lastModifiedDateTime	DateTimeOffset	The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
name	String	The attachment's file name.
size	Int32	The length of the attachment in bytes.

Graph reference: conversation

Property	Type	Description
hasAttachments	Boolean	Indicates whether any of the posts within this Conversation has at least one attachment. Supports `$filter` (`eq`, `ne`) and `$search`.
id	String	The conversations's unique identifier. Read-only.
lastDeliveredDateTime	DateTimeOffset	The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
preview	String	A short summary from the body of the latest post in this conversation. Supports `$filter` (`eq`, `ne`, `le`, `ge`).
topic	String	The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated.
uniqueSenders	String collection	All the users that sent a message to this Conversation.

Graph reference: conversationThread

Property	Type	Description
ccRecipients	recipient collection	The Cc: recipients for the thread. Returned only on `$select`.
hasAttachments	Boolean	Indicates whether any of the posts within this thread has at least one attachment. Returned by default.
id	String	Read-only. Returned by default.
isLocked	Boolean	Indicates if the thread is locked. Returned by default.
lastDeliveredDateTime	DateTimeOffset	The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Returned by default.
preview	String	A short summary from the body of the latest post in this conversation. Returned by default.
topic	String	The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated. Returned by default.
toRecipients	recipient collection	The To: recipients for the thread. Returned only on `$select`.
uniqueSenders	String collection	All the users that sent a message to this thread. Returned by default.

Graph reference: post

Property	Type	Description
body	itemBody	The contents of the post. This is a default property. This property can be null.
categories	String collection	The categories associated with the post.
changeKey	String	Identifies the version of the post. Every time the post is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
conversationId	String	Unique ID of the conversation. Read-only.
conversationThreadId	String	Unique ID of the conversation thread. Read-only.
createdDateTime	DateTimeOffset	Specifies when the post was created. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
from	recipient	Used in delegate access scenarios. Indicates who posted the message on behalf of another user. This is a default property.
hasAttachments	Boolean	Indicates whether the post has at least one attachment. This is a default property.
id	String	Read-only.
lastModifiedDateTime	DateTimeOffset	Specifies when the post was last modified. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
newParticipants	recipient collection	Conversation participants that were added to the thread as part of this post.
receivedDateTime	DateTimeOffset	Specifies when the post was received. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
sender	recipient	Contains the address of the sender. The value of Sender is assumed to be the address of the authenticated user in the case when Sender is not specified. This is a default property.

Table of Contents

Group-Conversation.ReadWrite.All

Graph Methods

Resources