Microsoft Graph Chats.chat API

The Chats.chat API from Microsoft Graph — 3 operation(s) for chats.chat.

Operations 6

GET /chats Microsoft Graph List chats #
POST /chats Microsoft Graph Create chat #
GET /chats/{chat-id} Microsoft Graph Get chat #
PATCH /chats/{chat-id} Microsoft Graph Update chat #
DELETE /chats/{chat-id} Microsoft Graph Delete chat #
GET /chats/$count Microsoft Graph Get the number of the resource #

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/admin?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/agreementacceptance?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/agreement?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/teamsapp?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/application?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/applicationtemplate?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/azure-ad-auditlog-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/authenticationmethodconfiguration?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/authenticationmethodspolicy?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/certificatebasedauthconfiguration?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/chat?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/communications-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/complianceapioverview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/externalconnectors-externalconnection?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/contact?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/contract?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/copilot-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/datapolicyoperation?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/intune-apps-conceptual?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/intune-device-conceptual?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/device?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/domaindnsrecord?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/domain?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/drive?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/education-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/employee-experience-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/externalconnectors-external?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/filter-query-parameter
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/excel?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/grouplifecyclepolicy?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/groupsetting?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/groupsettingtemplate?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/identitycontainer?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/informationprotection?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/invitation?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/users?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/oauth2permissiongrant?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/organization?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/resourcespecificpermissiongrant?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/place?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/planner-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/policy-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/print?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/privacy?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/report?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/rolemanagement?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/schemaextension?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/scopedrolemembership?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/search-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/security-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/serviceprincipal?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/shares?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/sharepoint?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/solutions-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/filestorage?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/subscribedsku?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/subscription?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/teamwork?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/tenantrelationship?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/auth/auth-concepts
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/workplace?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/sitepage?view=graph-rest-1.0

Specifications

Other Resources

Work with this as data

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-chat-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 Specification

microsoft-graph-chats-chat-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Microsoft Graph Admin Admin.admin Chats.chat 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.chat
paths:
  /chats:
    description: Provides operations to manage the collection of chat entities.
    get:
      tags:
      - Chats.chat
      summary: Microsoft Graph List chats
      description: Retrieve the list of chats that the user is part of. This method supports federation. When a user ID is provided, the calling application must belong to the same tenant that the user belongs to.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/chat-list?view=graph-rest-1.0
      operationId: chats.chat.ListChat
      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.chatCollectionResponse'
        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.chat
      summary: Microsoft Graph Create chat
      description: Create a new chat object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/chat-post?view=graph-rest-1.0
      operationId: chats.chat.CreateChat
      requestBody:
        description: New entity
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.chat'
        required: true
      responses:
        2XX:
          description: Created entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.chat'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /chats/{chat-id}:
    description: Provides operations to manage the collection of chat entities.
    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.chat
      summary: Microsoft Graph Get chat
      description: Retrieve a single chat (without its messages). This method supports federation. To access a chat, at least one chat member must belong to the tenant the request initiated from.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/chat-get?view=graph-rest-1.0
      operationId: chats.chat.GetChat
      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 entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.chat'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - Chats.chat
      summary: Microsoft Graph Update chat
      description: Update the properties of a chat object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/chat-patch?view=graph-rest-1.0
      operationId: chats.chat.UpdateChat
      requestBody:
        description: New property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.chat'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.chat'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - Chats.chat
      summary: Microsoft Graph Delete chat
      description: Soft-delete a chat. When invoked with delegated permissions, this operation only works for tenant admins and Teams service admins.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/chat-delete?view=graph-rest-1.0
      operationId: chats.chat.DeleteChat
      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/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
      - Chats.chat
      summary: Microsoft Graph Get the number of the resource
      operationId: chats.GetCount-61c7
      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:
    microsoft.graph.teamsAppResourceSpecificPermissionType:
      title: teamsAppResourceSpecificPermissionType
      enum:
      - delegated
      - application
      - unknownFutureValue
      type: string
    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.chatMessageInfo:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: chatMessageInfo
        required:
        - '@odata.type'
        type: object
        properties:
          body:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.itemBody'
            - type: object
              nullable: true
            description: Body of the chatMessage. This will still contain markers for @mentions and attachments even though the object doesn't return @mentions and attachments.
          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: Date time object representing the time at which message was created.
            format: date-time
            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, members were added, and so on. For event messages, the messageType property is set to systemEventMessage.
          from:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.chatMessageFromIdentitySet'
            - type: object
              nullable: true
            description: Information about the sender of the message.
          isDeleted:
            type: boolean
            description: If set to true, the original message has been deleted.
            nullable: true
          messageType:
            $ref: '#/components/schemas/microsoft.graph.chatMessageType'
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.chatMessageInfo'
    ODataCountResponse:
      type: integer
      format: int32
    microsoft.graph.chatCollectionResponse:
      title: Collection of chat
      type: object
      allOf:
      - $ref: '#/components/schemas/BaseCollectionPaginationCountResponse'
      - type: object
        properties:
          value:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.chat'
    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.teamsAppDefinition:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: teamsAppDefinition
        required:
        - '@odata.type'
        type: object
        properties:
          authorization:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.teamsAppAuthorization'
            - type: object
              nullable: true
            description: Authorization requirements specified in the Teams app manifest.
          createdBy:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identitySet'
            - type: object
              nullable: true
          description:
            type: string
            description: Verbose description of the application.
            nullable: true
          displayName:
            type: string
            description: The name of the app provided by the app developer.
            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
            format: date-time
            nullable: true
          publishingState:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.teamsAppPublishingState'
            - type: object
              nullable: true
            description: The published status of a specific version of a Teams app. The possible values are:submitted—The specific version of the Teams app was submitted and is under review.published—The request to publish the specific version of the Teams app was approved by the admin and the app is published.rejected—The admin rejected the request to publish the specific version of the Teams app.
          shortDescription:
            type: string
            description: Short description of the application.
            nullable: true
          teamsAppId:
            type: string
            description: The ID from the Teams app manifest.
            nullable: true
          version:
            type: string
            description: The version number of the application.
            nullable: true
          bot:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.teamworkBot'
            - type: object
              nullable: true
            description: The details of the bot specified in the Teams app manifest.
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.teamsAppDefinition'
    microsoft.graph.teamsApp:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: teamsApp
        required:
        - '@odata.type'
        type: object
        properties:
          displayName:
            type: string
            description: The name of the catalog app provided by the app developer in the Microsoft Teams zip app package.
            nullable: true
          distributionMethod:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.teamsAppDistributionMethod'
            - type: object
              nullable: true
            description: The method of distribution for the app. Read-only.
          externalId:
            type: string
            description: The ID of the catalog provided by the app developer in the Microsoft Teams zip app package.
            nullable: true
          appDefinitions:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.teamsAppDefinition'
            description: The details for each version of the app.
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.teamsApp'
    microsoft.graph.teamsAppResourceSpecificPermission:
      title: teamsAppResourceSpecificPermission
      required:
      - '@odata.type'
      type: object
      properties:
        permissionType:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.teamsAppResourceSpecificPermissionType'
          - type: object
            nullable: true
          description: The type of resource-specific permission.
        permissionValue:
          type: string
          description: The name of the resource-specific permission.
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.teamsTab:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: teamsTab
        required:
        - '@odata.type'
        type: object
        properties:
          configuration:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.teamsTabConfiguration'
            - type: object
              nullable: true
            description: Container for custom settings applied to a tab. The tab is considered configured only once this property is set.
          displayName:
            type: string
            description: Name of the tab.
            nullable: true
          webUrl:
            type: string
            description: Deep link URL of the tab instance. Read-only.
            nullable: true
          teamsApp:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.teamsApp'
            - type: object
              nullable: true
            description: The application that is linked to the tab. This can't be changed after tab creation.
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.teamsTab'
    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.chatViewpoint:
      title: chatViewpoint
      required:
      - '@odata.type'
      type: object
      properties:
        isHidden:
          type: boolean
          description: Indicates whether the chat is hidden for the current user.
          nullable: true
        lastMessageReadDateTime:
          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: Represents the dateTime up until which the current user has read chatMessages in a specific chat.
          format: date-time
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.chatType:
      title: chatType
      enum:
      - oneOnOne
      - group
      - meeting
      - unknownFutureValue
      type: string
    microsoft.graph.chatMessagePolicyViolationUserActionTypes:
      title: chatMessagePolicyViolationUserActionTypes
      enum:
      - none
      - override
      - reportFalsePositive
      type: string
      x-ms-enum-flags:
        isFlags: true
    microsoft.graph.teamworkBot:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: teamworkBot
        required:
        - '@odata.type'
        type: object
        properties:
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.teamworkBot'
    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.chat:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: chat
        required:
        - '@odata.type'
        type: object
        properties:
          chatType:
            $ref: '#/components/schemas/microsoft.graph.chatType'
          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: Date and time at which the chat was created. Read-only.
            format: date-time
            nullable: true
          isHiddenForAllMembers:
            type: boolean
            description: Indicates whether the chat is hidden for all its members. Read-only.
            nullable: true
          lastUpdatedDateTime:
            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 and time at which the chat was renamed or the list of members was last changed. Read-only.
            format: date-time
            nullable: true
          onlineMeetingInfo:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.teamworkOnlineMeetingInfo'
            - type: object
              nullable: true
            description: Represents details about an online meeting. If the chat isn't associated with an online meeting, the property is empty. Read-only.
          tenantId:
            type: string
            description: The identifier of the tenant in which the chat was created. Read-only.
            nullable: true
          topic:
            type: string
            description: (Optional) Subject or topic for the chat. Only available for group chats.
            nullable: true
          viewpoint:
            anyOf:
            - $ref: '#/components/schemas/microsoft.gr

# --- truncated at 32 KB (190 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/microsoft-graph-chats-chat-api-openapi.yml