Show / Hide Table of Contents

Chat.ReadBasic.All

Read names and members of all one-to-one and group chats in Microsoft Teams, without a signed-in user.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver Type Method
V1 A GET /chats
V1 A GET /chats/{chat-id}
V1 A GET /chats/{chat-id}/members
V1 A GET /chats/{chat-id}/members/{membership-id}
V1 A GET /chats/{chat-id}/operations
V1 A GET /chats/{chat-id}/operations/{operation-id}
V1 A GET /me/chats/{chat-id}
V1 A GET /users/{user-id | user-principal-name}/chats/{chat-id}
V1 A GET /users/{user-id | user-principal-name}/chats/{chat-id}/members
V1 A GET /users/{user-id | user-principal-name}/chats/{chat-id}/members/{membership-id}
V1 A GET /users/{user-id} | user-principal-name/chats/{chat-id}/members/{membership-id}

Application Permission

Id b2e060da-3baf-4687-9611-f4ebc0f0cbde
Display String Read names and members of all chat threads
Description Read names and members of all one-to-one and group chats in Microsoft Teams, without a signed-in user.

Resources

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.
lastUpdatedDateTime dateTimeOffset Date and time at which the chat was renamed or list of members were 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 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.

conversationMember

Property Type Description
displayName string The display name of the user.
id String Read-only. Unique ID of the user.
roles string collection The roles for that user. This property only contains additional qualifiers when relevant - for example, if the member has owner privileges, the roles property contains owner as one of the values. Similarly, if the member is a guest, the roles property contains guest as one of the values. A basic member should not have any values specified in the roles property.
visibleHistoryStartDateTime DateTimeOffset The timestamp denoting how far back a conversation's history is shared with the conversation member. This property is settable only for members of a chat.

teamsAsyncOperation

Property Type Description
attemptsCount Int32 Number of times the operation was attempted before being marked successful or failed.
createdDateTime DateTimeOffset Time when the operation was created.
error operationError Any error that causes the async operation to fail.
id string Unique operation id.
lastActionDateTime DateTimeOffset Time when the async operation was last updated.
operationType teamsAsyncOperationType Denotes which type of operation is being described.
status teamsAsyncOperationStatus Operation status.
targetResourceId guid The ID of the object that's created or modified as result of this async operation, typically a team.
targetResourceLocation string The location of the object that's created or modified as result of this async operation. This URL should be treated as an opaque value and not parsed into its component paths.
In This Article
Back to top Created by merill | Submit feedback