Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-graph-chats-pinnedchatmessageinfo-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Microsoft Graph Admin Admin.admin Chats.pinned Chat Message Info API
description: 'Microsoft Graph API for managing administrative resources in Microsoft Entra ID.
This API enables administrators to manage Microsoft Edge browser settings, Internet Explorer mode configurations,
site lists, shared browser sites, Microsoft 365 Apps installation options, people insights, service announcements,
SharePoint settings, Copilot administration, directory administrative units, and admin consent policies.'
version: 1.0.0
contact:
name: Microsoft Graph API Support
url: https://developer.microsoft.com/graph
servers:
- url: https://graph.microsoft.com/v1.0
description: Microsoft Graph API v1.0 endpoint
tags:
- name: chats.pinnedChatMessageInfo
paths:
/chats/{chat-id}/pinnedMessages:
description: Provides operations to manage the pinnedMessages property of the microsoft.graph.chat entity.
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
schema:
type: string
x-ms-docs-key-type: chat
get:
tags:
- chats.pinnedChatMessageInfo
summary: Microsoft Graph List pinnedChatMessages in a chat
description: Get a list of pinnedChatMessages in a chat.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/chat-list-pinnedmessages?view=graph-rest-1.0
operationId: chats.ListPinnedMessages
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.pinnedChatMessageInfoCollectionResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- chats.pinnedChatMessageInfo
summary: Microsoft Graph Pin a message in a chat
description: Pin a chat message in the specified chat. This API cannot create a new chat; you must use the list chats method to retrieve the ID of an existing chat before you can pin a chat message.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/chat-post-pinnedmessages?view=graph-rest-1.0
operationId: chats.CreatePinnedMessages
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.pinnedChatMessageInfo'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.pinnedChatMessageInfo'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/chats/{chat-id}/pinnedMessages/{pinnedChatMessageInfo-id}:
description: Provides operations to manage the pinnedMessages property of the microsoft.graph.chat entity.
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
schema:
type: string
x-ms-docs-key-type: chat
- name: pinnedChatMessageInfo-id
in: path
description: The unique identifier of pinnedChatMessageInfo
required: true
schema:
type: string
x-ms-docs-key-type: pinnedChatMessageInfo
get:
tags:
- chats.pinnedChatMessageInfo
summary: Microsoft Graph Get pinnedMessages from chats
description: A collection of all the pinned messages in the chat. Nullable.
operationId: chats.GetPinnedMessages
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.pinnedChatMessageInfo'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- chats.pinnedChatMessageInfo
summary: Microsoft Graph Update the navigation property pinnedMessages in chats
operationId: chats.UpdatePinnedMessages
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.pinnedChatMessageInfo'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.pinnedChatMessageInfo'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- chats.pinnedChatMessageInfo
summary: Microsoft Graph Unpin a message from a chat
description: Unpin a message from a chat.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/chat-delete-pinnedmessages?view=graph-rest-1.0
operationId: chats.DeletePinnedMessages
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/chats/{chat-id}/pinnedMessages/{pinnedChatMessageInfo-id}/message:
description: Provides operations to manage the message property of the microsoft.graph.pinnedChatMessageInfo entity.
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
schema:
type: string
x-ms-docs-key-type: chat
- name: pinnedChatMessageInfo-id
in: path
description: The unique identifier of pinnedChatMessageInfo
required: true
schema:
type: string
x-ms-docs-key-type: pinnedChatMessageInfo
get:
tags:
- chats.pinnedChatMessageInfo
summary: Microsoft Graph Get message from chats
description: Represents details about the chat message that is pinned.
operationId: chats.pinnedMessages.GetMessage
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.chatMessage'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/chats/{chat-id}/pinnedMessages/$count:
description: Provides operations to count the resources in the collection.
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
schema:
type: string
x-ms-docs-key-type: chat
get:
tags:
- chats.pinnedChatMessageInfo
summary: Microsoft Graph Get the number of the resource
operationId: chats.pinnedMessages.GetCount-ad15
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
components:
schemas:
ODataCountResponse:
type: integer
format: int32
microsoft.graph.ODataErrors.ErrorDetails:
required:
- code
- message
type: object
properties:
code:
type: string
message:
type: string
target:
type: string
nullable: true
microsoft.graph.teamworkHostedContent:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: teamworkHostedContent
required:
- '@odata.type'
type: object
properties:
contentBytes:
type: string
description: Write only. Bytes for the hosted content (such as images).
format: base64url
nullable: true
contentType:
type: string
description: Write only. Content type. such as image/png, image/jpg.
nullable: true
'@odata.type':
type: string
discriminator:
propertyName: '@odata.type'
mapping:
'#microsoft.graph.chatMessageHostedContent': '#/components/schemas/microsoft.graph.chatMessageHostedContent'
microsoft.graph.identitySet:
title: identitySet
required:
- '@odata.type'
type: object
properties:
application:
anyOf:
- $ref: '#/components/schemas/microsoft.graph.identity'
- type: object
nullable: true
description: Optional. The application associated with this action.
device:
anyOf:
- $ref: '#/components/schemas/microsoft.graph.identity'
- type: object
nullable: true
description: Optional. The device associated with this action.
user:
anyOf:
- $ref: '#/components/schemas/microsoft.graph.identity'
- type: object
nullable: true
description: Optional. The user associated with this action.
'@odata.type':
type: string
discriminator:
propertyName: '@odata.type'
mapping:
'#microsoft.graph.aiInteractionMentionedIdentitySet': '#/components/schemas/microsoft.graph.aiInteractionMentionedIdentitySet'
'#microsoft.graph.chatMessageFromIdentitySet': '#/components/schemas/microsoft.graph.chatMessageFromIdentitySet'
'#microsoft.graph.chatMessageMentionedIdentitySet': '#/components/schemas/microsoft.graph.chatMessageMentionedIdentitySet'
'#microsoft.graph.chatMessageReactionIdentitySet': '#/components/schemas/microsoft.graph.chatMessageReactionIdentitySet'
'#microsoft.graph.communicationsIdentitySet': '#/components/schemas/microsoft.graph.communicationsIdentitySet'
'#microsoft.graph.engagementIdentitySet': '#/components/schemas/microsoft.graph.engagementIdentitySet'
'#microsoft.graph.sharePointIdentitySet': '#/components/schemas/microsoft.graph.sharePointIdentitySet'
microsoft.graph.identity:
title: identity
required:
- '@odata.type'
type: object
properties:
displayName:
type: string
description: The display name of the identity.For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
nullable: true
id:
type: string
description: Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
nullable: true
'@odata.type':
type: string
discriminator:
propertyName: '@odata.type'
mapping:
'#microsoft.graph.azureCommunicationServicesUserIdentity': '#/components/schemas/microsoft.graph.azureCommunicationServicesUserIdentity'
'#microsoft.graph.communicationsApplicationIdentity': '#/components/schemas/microsoft.graph.communicationsApplicationIdentity'
'#microsoft.graph.communicationsApplicationInstanceIdentity': '#/components/schemas/microsoft.graph.communicationsApplicationInstanceIdentity'
'#microsoft.graph.communicationsEncryptedIdentity': '#/components/schemas/microsoft.graph.communicationsEncryptedIdentity'
'#microsoft.graph.communicationsGuestIdentity': '#/components/schemas/microsoft.graph.communicationsGuestIdentity'
'#microsoft.graph.communicationsPhoneIdentity': '#/components/schemas/microsoft.graph.communicationsPhoneIdentity'
'#microsoft.graph.communicationsUserIdentity': '#/components/schemas/microsoft.graph.communicationsUserIdentity'
'#microsoft.graph.emailIdentity': '#/components/schemas/microsoft.graph.emailIdentity'
'#microsoft.graph.initiator': '#/components/schemas/microsoft.graph.initiator'
'#microsoft.graph.provisionedIdentity': '#/components/schemas/microsoft.graph.provisionedIdentity'
'#microsoft.graph.provisioningServicePrincipal': '#/components/schemas/microsoft.graph.provisioningServicePrincipal'
'#microsoft.graph.provisioningSystem': '#/components/schemas/microsoft.graph.provisioningSystem'
'#microsoft.graph.servicePrincipalIdentity': '#/components/schemas/microsoft.graph.servicePrincipalIdentity'
'#microsoft.graph.sharePointIdentity': '#/components/schemas/microsoft.graph.sharePointIdentity'
'#microsoft.graph.teamworkApplicationIdentity': '#/components/schemas/microsoft.graph.teamworkApplicationIdentity'
'#microsoft.graph.teamworkConversationIdentity': '#/components/schemas/microsoft.graph.teamworkConversationIdentity'
'#microsoft.graph.teamworkTagIdentity': '#/components/schemas/microsoft.graph.teamworkTagIdentity'
'#microsoft.graph.teamworkUserIdentity': '#/components/schemas/microsoft.graph.teamworkUserIdentity'
'#microsoft.graph.userIdentity': '#/components/schemas/microsoft.graph.userIdentity'
'#microsoft.graph.callRecords.userIdentity': '#/components/schemas/microsoft.graph.callRecords.userIdentity'
microsoft.graph.chatMessageHostedContent:
allOf:
- $ref: '#/components/schemas/microsoft.graph.teamworkHostedContent'
- title: chatMessageHostedContent
required:
- '@odata.type'
type: object
properties:
'@odata.type':
type: string
x-ms-discriminator-value: '#microsoft.graph.chatMessageHostedContent'
microsoft.graph.chatMessagePolicyViolationPolicyTip:
title: chatMessagePolicyViolationPolicyTip
required:
- '@odata.type'
type: object
properties:
complianceUrl:
type: string
description: The URL a user can visit to read about the data loss prevention policies for the organization. (ie, policies about what users shouldn't say in chats)
nullable: true
generalText:
type: string
description: Explanatory text shown to the sender of the message.
nullable: true
matchedConditionDescriptions:
type: array
items:
type: string
nullable: true
description: The list of improper data in the message that was detected by the data loss prevention app. Each DLP app defines its own conditions, examples include 'Credit Card Number' and 'Social Security Number'.
'@odata.type':
type: string
microsoft.graph.chatMessagePolicyViolationDlpActionTypes:
title: chatMessagePolicyViolationDlpActionTypes
enum:
- none
- notifySender
- blockAccess
- blockAccessExternal
type: string
x-ms-enum-flags:
isFlags: true
microsoft.graph.itemBody:
title: itemBody
required:
- '@odata.type'
type: object
properties:
content:
type: string
description: The content of the item.
nullable: true
contentType:
anyOf:
- $ref: '#/components/schemas/microsoft.graph.bodyType'
- type: object
nullable: true
description: The type of the content. Possible values are text and html.
'@odata.type':
type: string
microsoft.graph.chatMessageActions:
title: chatMessageActions
enum:
- reactionAdded
- reactionRemoved
- actionUndefined
- unknownFutureValue
type: string
x-ms-enum-flags:
isFlags: true
microsoft.graph.chatMessagePolicyViolationVerdictDetailsTypes:
title: chatMessagePolicyViolationVerdictDetailsTypes
enum:
- none
- allowFalsePositiveOverride
- allowOverrideWithoutJustification
- allowOverrideWithJustification
type: string
x-ms-enum-flags:
isFlags: true
microsoft.graph.channelIdentity:
title: channelIdentity
required:
- '@odata.type'
type: object
properties:
channelId:
type: string
description: The identity of the channel in which the message was posted.
nullable: true
teamId:
type: string
description: The identity of the team in which the message was posted.
nullable: true
'@odata.type':
type: string
microsoft.graph.teamworkConversationIdentity:
allOf:
- $ref: '#/components/schemas/microsoft.graph.identity'
- title: teamworkConversationIdentity
required:
- '@odata.type'
type: object
properties:
conversationIdentityType:
anyOf:
- $ref: '#/components/schemas/microsoft.graph.teamworkConversationIdentityType'
- type: object
nullable: true
description: 'Type of conversation. The possible values are: team, channel, chat, and unknownFutureValue.'
'@odata.type':
type: string
default: '#microsoft.graph.teamworkConversationIdentity'
x-ms-discriminator-value: '#microsoft.graph.teamworkConversationIdentity'
microsoft.graph.ODataErrors.InnerError:
title: InnerError
required:
- '@odata.type'
type: object
properties:
request-id:
type: string
description: Request Id as tracked internally by the service
nullable: true
client-request-id:
type: string
description: Client request Id as sent by the client application.
nullable: true
date:
pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
type: string
description: Date when the error occured.
format: date-time
nullable: true
'@odata.type':
type: string
microsoft.graph.chatMessagePolicyViolationUserActionTypes:
title: chatMessagePolicyViolationUserActionTypes
enum:
- none
- override
- reportFalsePositive
type: string
x-ms-enum-flags:
isFlags: true
microsoft.graph.pinnedChatMessageInfoCollectionResponse:
title: Collection of pinnedChatMessageInfo
type: object
allOf:
- $ref: '#/components/schemas/BaseCollectionPaginationCountResponse'
- type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.pinnedChatMessageInfo'
microsoft.graph.eventMessageDetail:
title: eventMessageDetail
required:
- '@odata.type'
type: object
properties:
'@odata.type':
type: string
discriminator:
propertyName: '@odata.type'
mapping:
'#microsoft.graph.callEndedEventMessageDetail': '#/components/schemas/microsoft.graph.callEndedEventMessageDetail'
'#microsoft.graph.callRecordingEventMessageDetail': '#/components/schemas/microsoft.graph.callRecordingEventMessageDetail'
'#microsoft.graph.callStartedEventMessageDetail': '#/components/schemas/microsoft.graph.callStartedEventMessageDetail'
'#microsoft.graph.callTranscriptEventMessageDetail': '#/components/schemas/microsoft.graph.callTranscriptEventMessageDetail'
'#microsoft.graph.channelAddedEventMessageDetail': '#/components/schemas/microsoft.graph.channelAddedEventMessageDetail'
'#microsoft.graph.channelDeletedEventMessageDetail': '#/components/schemas/microsoft.graph.channelDeletedEventMessageDetail'
'#microsoft.graph.channelDescriptionUpdatedEventMessageDetail': '#/components/schemas/microsoft.graph.channelDescriptionUpdatedEventMessageDetail'
'#microsoft.graph.channelRenamedEventMessageDetail': '#/components/schemas/microsoft.graph.channelRenamedEventMessageDetail'
'#microsoft.graph.channelSetAsFavoriteByDefaultEventMessageDetail': '#/components/schemas/microsoft.graph.channelSetAsFavoriteByDefaultEventMessageDetail'
'#microsoft.graph.channelUnsetAsFavoriteByDefaultEventMessageDetail': '#/components/schemas/microsoft.graph.channelUnsetAsFavoriteByDefaultEventMessageDetail'
'#microsoft.graph.chatRenamedEventMessageDetail': '#/components/schemas/microsoft.graph.chatRenamedEventMessageDetail'
'#microsoft.graph.conversationMemberRoleUpdatedEventMessageDetail': '#/components/schemas/microsoft.graph.conversationMemberRoleUpdatedEventMessageDetail'
'#microsoft.graph.meetingPolicyUpdatedEventMessageDetail': '#/components/schemas/microsoft.graph.meetingPolicyUpdatedEventMessageDetail'
'#microsoft.graph.membersAddedEventMessageDetail': '#/components/schemas/microsoft.graph.membersAddedEventMessageDetail'
'#microsoft.graph.membersDeletedEventMessageDetail': '#/components/schemas/microsoft.graph.membersDeletedEventMessageDetail'
'#microsoft.graph.membersJoinedEventMessageDetail': '#/components/schemas/microsoft.graph.membersJoinedEventMessageDetail'
'#microsoft.graph.membersLeftEventMessageDetail': '#/components/schemas/microsoft.graph.membersLeftEventMessageDetail'
'#microsoft.graph.messagePinnedEventMessageDetail': '#/components/schemas/microsoft.graph.messagePinnedEventMessageDetail'
'#microsoft.graph.messageUnpinnedEventMessageDetail': '#/components/schemas/microsoft.graph.messageUnpinnedEventMessageDetail'
'#microsoft.graph.tabUpdatedEventMessageDetail': '#/components/schemas/microsoft.graph.tabUpdatedEventMessageDetail'
'#microsoft.graph.teamArchivedEventMessageDetail': '#/components/schemas/microsoft.graph.teamArchivedEventMessageDetail'
'#microsoft.graph.teamCreatedEventMessageDetail': '#/components/schemas/microsoft.graph.teamCreatedEventMessageDetail'
'#microsoft.graph.teamDescriptionUpdatedEventMessageDetail': '#/components/schemas/microsoft.graph.teamDescriptionUpdatedEventMessageDetail'
'#microsoft.graph.teamJoiningDisabledEventMessageDetail': '#/components/schemas/microsoft.graph.teamJoiningDisabledEventMessageDetail'
'#microsoft.graph.teamJoiningEnabledEventMessageDetail': '#/components/schemas/microsoft.graph.teamJoiningEnabledEventMessageDetail'
'#microsoft.graph.teamRenamedEventMessageDetail': '#/components/schemas/microsoft.graph.teamRenamedEventMessageDetail'
'#microsoft.graph.teamsAppInstalledEventMessageDetail': '#/components/schemas/microsoft.graph.teamsAppInstalledEventMessageDetail'
'#microsoft.graph.teamsAppRemovedEventMessageDetail': '#/components/schemas/microsoft.graph.teamsAppRemovedEventMessageDetail'
'#microsoft.graph.teamsAppUpgradedEventMessageDetail': '#/components/schemas/microsoft.graph.teamsAppUpgradedEventMessageDetail'
'#microsoft.graph.teamUnarchivedEventMessageDetail': '#/components/schemas/microsoft.graph.teamUnarchivedEventMessageDetail'
microsoft.graph.chatMessage:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: chatMessage
required:
- '@odata.type'
type: object
properties:
attachments:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.chatMessageAttachment'
description: References to attached objects like files, tabs, meetings etc.
body:
$ref: '#/components/schemas/microsoft.graph.itemBody'
channelIdentity:
anyOf:
- $ref: '#/components/schemas/microsoft.graph.channelIdentity'
- type: object
nullable: true
description: If the message was sent in a channel, represents identity of the channel.
chatId:
type: string
description: If the message was sent in a chat, represents the identity of the chat.
nullable: true
createdDateTime:
pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
type: string
description: Timestamp of when the chat message was created.
format: date-time
nullable: true
deletedDateTime:
pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
type: string
description: Read only. Timestamp at which the chat message was deleted, or null if not deleted.
format: date-time
nullable: true
etag:
type: string
description: Read-only. Version number of the chat message.
nullable: true
eventDetail:
anyOf:
- $ref: '#/components/schemas/microsoft.graph.eventMessageDetail'
- type: object
nullable: true
description: Read-only. If present, represents details of an event that happened in a chat, a channel, or a team, for example, adding new members. For event messages, the messageType property will be set to systemEventMessage.
from:
anyOf:
- $ref: '#/components/schemas/microsoft.graph.chatMessageFromIdentitySet'
- type: object
nullable: true
description: Details of the sender of the chat message. Can only be set during migration.
importance:
$ref: '#/components/schemas/microsoft.graph.chatMessageImportance'
lastEditedDateTime:
pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
type: string
description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
type: string
description: Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.
format: date-time
nullable: true
locale:
type: string
description: Locale of the chat message set by the client. Always set to en-us.
mentions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.chatMessageMention'
description: 'List of entities mentioned in the chat message. Supported entities are: user, bot, team, channel, chat, and tag.'
messageHistory:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.chatMessageHistoryItem'
description: List of activity history of a message item, including modification time and actions, such as reactionAdded, reactionRemoved, or reaction changes, on the message.
messageType:
$ref: '#/components/schemas/microsoft.graph.chatMessageType'
policyViolation:
anyOf:
- $ref: '#/components/schemas/microsoft.graph.chatMessagePolicyViolation'
- type: object
nullable: true
description: Defines the properties of a policy violation set by a data loss prevention (DLP) application.
reactions:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.chatMessageReaction'
description: Reactions for this chat message (for example, Like).
replyToId:
type: string
description: Read-only. ID of the parent chat message or root chat message of the thread. (Only applies to chat messages in channels, not chats.)
nullable: true
subject:
type: string
description: The subject of the chat message, in plaintext.
nullable: true
summary:
type: string
description: Summary text of the chat message that could be used for push notifications and summary views or fall back views. Only applies to channel chat messages, not chat messages in a chat.
nullable: true
webUrl:
type: string
description: Read-only. Link to the message in Microsoft Teams.
nullable: true
hostedContents:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.chatMessageHostedContent'
description: Content in a message hosted by Microsoft Teams - for example, images or code snippets.
x-ms-navigationProperty: true
replies:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.chatMessage'
description: Replies for a specified message. Supports $expand for channel messages.
x-ms-navigationProperty: true
'@odata.type':
type: string
x-ms-discriminator-value: '#microsoft.graph.chatMessage'
microsoft.graph.chatMessageReaction:
title: chatMessageReaction
required:
- '@odata.type'
type: object
properties:
createdDateTime:
pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
type: string
description: The timestamp type represents date and time info
# --- truncated at 32 KB (165 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/microsoft-graph-chats-pinnedchatmessageinfo-api-openapi.yml