Microsoft Graph communications.cloudCommunications API

The communications.cloudCommunications API from Microsoft Graph — 1 operation(s) for communications.cloudcommunications.

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

OpenAPI Specification

microsoft-graph-communications-cloudcommunications-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Microsoft Graph Admin Admin.admin communications.cloudCommunications 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: communications.cloudCommunications
paths:
  /communications:
    description: Provides operations to manage the cloudCommunications singleton.
    get:
      tags:
      - communications.cloudCommunications
      summary: Microsoft Graph Get communications
      operationId: communications.cloudCommunications.GetCloudCommunications
      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.cloudCommunications'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - communications.cloudCommunications
      summary: Microsoft Graph Update communications
      operationId: communications.cloudCommunications.UpdateCloudCommunications
      requestBody:
        description: New property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.cloudCommunications'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.cloudCommunications'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
components:
  schemas:
    microsoft.graph.communicationsIdentitySet:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.identitySet'
      - title: communicationsIdentitySet
        required:
        - '@odata.type'
        type: object
        properties:
          applicationInstance:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identity'
            - type: object
              nullable: true
            description: The application instance associated with this action.
          assertedIdentity:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identity'
            - type: object
              nullable: true
            description: An identity the participant would like to present itself as to the other participants in the call.
          azureCommunicationServicesUser:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identity'
            - type: object
              nullable: true
            description: The Azure Communication Services user associated with this action.
          encrypted:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identity'
            - type: object
              nullable: true
            description: The encrypted user associated with this action.
          endpointType:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.endpointType'
            - type: object
              nullable: true
            description: 'Type of endpoint that the participant uses. The possible values are: default, voicemail, skypeForBusiness, skypeForBusinessVoipPhone, unknownFutureValue.'
          guest:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identity'
            - type: object
              nullable: true
            description: The guest user associated with this action.
          onPremises:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identity'
            - type: object
              nullable: true
            description: The Skype for Business on-premises user associated with this action.
          phone:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identity'
            - type: object
              nullable: true
            description: The phone user associated with this action.
          '@odata.type':
            type: string
            default: '#microsoft.graph.communicationsIdentitySet'
      x-ms-discriminator-value: '#microsoft.graph.communicationsIdentitySet'
    microsoft.graph.dateTimeTimeZone:
      title: dateTimeTimeZone
      required:
      - '@odata.type'
      type: object
      properties:
        dateTime:
          type: string
          description: A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000).
        timeZone:
          type: string
          description: Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values.
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.callRecords.callType:
      title: callType
      enum:
      - unknown
      - groupCall
      - peerToPeer
      - unknownFutureValue
      type: string
    microsoft.graph.onlineMeetingPresenters:
      title: onlineMeetingPresenters
      enum:
      - everyone
      - organization
      - roleIsPresenter
      - organizer
      - unknownFutureValue
      type: string
    ReferenceNumeric:
      enum:
      - -INF
      - INF
      - NaN
      type: string
      nullable: true
    microsoft.graph.mediaConfig:
      title: mediaConfig
      required:
      - '@odata.type'
      type: object
      properties:
        '@odata.type':
          type: string
      discriminator:
        propertyName: '@odata.type'
        mapping:
          '#microsoft.graph.appHostedMediaConfig': '#/components/schemas/microsoft.graph.appHostedMediaConfig'
          '#microsoft.graph.serviceHostedMediaConfig': '#/components/schemas/microsoft.graph.serviceHostedMediaConfig'
    microsoft.graph.cloudCommunications:
      title: cloudCommunications
      required:
      - '@odata.type'
      type: object
      properties:
        callRecords:
          type: array
          items:
            $ref: '#/components/schemas/microsoft.graph.callRecords.callRecord'
          x-ms-navigationProperty: true
        calls:
          type: array
          items:
            $ref: '#/components/schemas/microsoft.graph.call'
          x-ms-navigationProperty: true
        onlineMeetingConversations:
          type: array
          items:
            $ref: '#/components/schemas/microsoft.graph.onlineMeetingEngagementConversation'
          description: A collection of structured question-and-answer (Q&A) threads in Teams directly associated with online meetings.
          x-ms-navigationProperty: true
        onlineMeetings:
          type: array
          items:
            $ref: '#/components/schemas/microsoft.graph.onlineMeeting'
          x-ms-navigationProperty: true
        presences:
          type: array
          items:
            $ref: '#/components/schemas/microsoft.graph.presence'
          x-ms-navigationProperty: true
        '@odata.type':
          type: string
      description: Represents a container that exposes navigation properties for cloud communications resources.
    microsoft.graph.resultInfo:
      title: resultInfo
      required:
      - '@odata.type'
      type: object
      properties:
        code:
          maximum: 2147483647
          minimum: -2147483648
          type: number
          description: The result code.
          format: int32
        message:
          type: string
          description: The message.
          nullable: true
        subcode:
          maximum: 2147483647
          minimum: -2147483648
          type: number
          description: The result subcode.
          format: int32
        '@odata.type':
          type: string
    microsoft.graph.callRecording:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: callRecording
        required:
        - '@odata.type'
        type: object
        properties:
          callId:
            type: string
            description: The unique identifier for the call that is related to this recording. Read-only.
            nullable: true
          content:
            type: string
            description: The content of the recording. Read-only.
            format: base64url
            nullable: true
          contentCorrelationId:
            type: string
            description: The unique identifier that links the transcript with its corresponding recording. Read-only.
            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: Date and time at which the recording was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.
            format: date-time
            nullable: true
          endDateTime:
            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 recording ends. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.
            format: date-time
            nullable: true
          meetingId:
            type: string
            description: The unique identifier of the onlineMeeting related to this recording. Read-only.
            nullable: true
          meetingOrganizer:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identitySet'
            - type: object
              nullable: true
            description: The identity information of the organizer of the onlineMeeting related to this recording. Read-only.
          recordingContentUrl:
            type: string
            description: The URL that can be used to access the content of the recording. Read-only.
            nullable: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.callRecording'
    microsoft.graph.callRecords.participantBase:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: participantBase
        required:
        - '@odata.type'
        type: object
        properties:
          administrativeUnitInfos:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.callRecords.administrativeUnitInfo'
            description: List of administrativeUnitInfo objects for the call participant.
          identity:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.communicationsIdentitySet'
            - type: object
              nullable: true
            description: The identity of the call participant.
          '@odata.type':
            type: string
        discriminator:
          propertyName: '@odata.type'
          mapping:
            '#microsoft.graph.callRecords.organizer': '#/components/schemas/microsoft.graph.callRecords.organizer'
            '#microsoft.graph.callRecords.participant': '#/components/schemas/microsoft.graph.callRecords.participant'
    microsoft.graph.callRecords.segment:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: segment
        required:
        - '@odata.type'
        type: object
        properties:
          callee:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.callRecords.endpoint'
            - type: object
              nullable: true
            description: Endpoint that answered this segment.
          caller:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.callRecords.endpoint'
            - type: object
              nullable: true
            description: Endpoint that initiated this segment.
          endDateTime:
            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: UTC time when the segment ended. 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
            format: date-time
          failureInfo:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.callRecords.failureInfo'
            - type: object
              nullable: true
            description: Failure information associated with the segment if it failed.
          media:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.callRecords.media'
            description: Media associated with this segment.
          startDateTime:
            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: UTC time when the segment started. 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
            format: date-time
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.callRecords.segment'
    microsoft.graph.callRecords.failureStage:
      title: failureStage
      enum:
      - unknown
      - callSetup
      - midcall
      - unknownFutureValue
      type: string
    microsoft.graph.callMediaState:
      title: callMediaState
      required:
      - '@odata.type'
      type: object
      properties:
        audio:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.mediaState'
          - type: object
            nullable: true
          description: 'The audio media state. The possible values are: active, inactive, unknownFutureValue.'
        '@odata.type':
          type: string
    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.callRecords.networkConnectionType:
      title: networkConnectionType
      enum:
      - unknown
      - wired
      - wifi
      - mobile
      - tunnel
      - unknownFutureValue
      type: string
    microsoft.graph.callRecords.failureInfo:
      title: failureInfo
      required:
      - '@odata.type'
      type: object
      properties:
        reason:
          type: string
          description: Classification of why a call or portion of a call failed.
          nullable: true
        stage:
          $ref: '#/components/schemas/microsoft.graph.callRecords.failureStage'
        '@odata.type':
          type: string
    microsoft.graph.callTranscriptionState:
      title: callTranscriptionState
      enum:
      - notStarted
      - active
      - inactive
      - unknownFutureValue
      type: string
    microsoft.graph.callOptions:
      title: callOptions
      required:
      - '@odata.type'
      type: object
      properties:
        hideBotAfterEscalation:
          type: boolean
          description: Indicates whether to hide the app after the call is escalated.
          nullable: true
        isContentSharingNotificationEnabled:
          type: boolean
          description: Indicates whether content sharing notifications should be enabled for the call.
          nullable: true
        isDeltaRosterEnabled:
          type: boolean
          description: Indicates whether delta roster is enabled for the call.
          nullable: true
        isInteractiveRosterEnabled:
          type: boolean
          description: Indicates whether delta roster filtering by participant interactivity is enabled.
          nullable: true
        '@odata.type':
          type: string
      discriminator:
        propertyName: '@odata.type'
        mapping:
          '#microsoft.graph.incomingCallOptions': '#/components/schemas/microsoft.graph.incomingCallOptions'
          '#microsoft.graph.outgoingCallOptions': '#/components/schemas/microsoft.graph.outgoingCallOptions'
    microsoft.graph.audioConferencing:
      title: audioConferencing
      required:
      - '@odata.type'
      type: object
      properties:
        conferenceId:
          type: string
          description: The conference id of the online meeting.
          nullable: true
        dialinUrl:
          type: string
          description: A URL to the externally-accessible web page that contains dial-in information.
          nullable: true
        tollFreeNumber:
          type: string
          description: The toll-free number that connects to the Audio Conference Provider.
          nullable: true
        tollFreeNumbers:
          type: array
          items:
            type: string
            nullable: true
          description: List of toll-free numbers that are displayed in the meeting invite.
        tollNumber:
          type: string
          description: The toll number that connects to the Audio Conference Provider.
          nullable: true
        tollNumbers:
          type: array
          items:
            type: string
            nullable: true
          description: List of toll numbers that are displayed in the meeting invite.
        '@odata.type':
          type: string
    microsoft.graph.routingType:
      title: routingType
      enum:
      - forwarded
      - lookup
      - selfFork
      - unknownFutureValue
      type: string
    microsoft.graph.callState:
      title: callState
      enum:
      - incoming
      - establishing
      - established
      - hold
      - transferring
      - transferAccepted
      - redirecting
      - terminating
      - terminated
      - unknownFutureValue
      type: string
    microsoft.graph.endpointType:
      title: endpointType
      enum:
      - default
      - voicemail
      - skypeForBusiness
      - skypeForBusinessVoipPhone
      - unknownFutureValue
      type: string
    microsoft.graph.callRecords.participant:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.callRecords.participantBase'
      - title: participant
        required:
        - '@odata.type'
        type: object
        properties:
          '@odata.type':
            type: string
            default: '#microsoft.graph.callRecords.participant'
      x-ms-discriminator-value: '#microsoft.graph.callRecords.participant'
    microsoft.graph.callRecords.audioCodec:
      title: audioCodec
      enum:
      - unknown
      - invalid
      - cn
      - pcma
      - pcmu
      - amrWide
      - g722
      - g7221
      - g7221c
      - g729
      - multiChannelAudio
      - muchv2
      - opus
      - satin
      - satinFullband
      - rtAudio8
      - rtAudio16
      - silk
      - silkNarrow
      - silkWide
      - siren
      - xmsRta
      - unknownFutureValue
      type: string
    microsoft.graph.callRecords.mediaStream:
      title: mediaStream
      required:
      - '@odata.type'
      type: object
      properties:
        audioCodec:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.callRecords.audioCodec'
          - type: object
            nullable: true
          description: 'Codec name used to encode audio for transmission on the network. The possible values are: unknown, invalid, cn, pcma, pcmu, amrWide, g722, g7221, g7221c, g729, multiChannelAudio, muchv2, opus, satin, satinFullband, rtAudio8, rtAudio16, silk, silkNarrow, silkWide, siren, xmsRta, unknownFutureValue.'
        averageAudioDegradation:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Average Network Mean Opinion Score degradation for stream. Represents how much the network loss and jitter has impacted the quality of received audio.
        averageAudioNetworkJitter:
          pattern: ^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$
          type: string
          description: Average jitter for the stream computed as specified in RFC 3550, denoted in ISO 8601 format. For example, 1 second is denoted as 'PT1S', where 'P' is the duration designator, 'T' is the time designator, and 'S' is the second designator.
          format: duration
          nullable: true
        averageBandwidthEstimate:
          type: number
          description: Average estimated bandwidth available between two endpoints in bits per second.
          format: int64
          nullable: true
        averageFreezeDuration:
          pattern: ^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$
          type: string
          description: Average duration of the received freezing time in the video stream.
          format: duration
          nullable: true
        averageJitter:
          pattern: ^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$
          type: string
          description: Average jitter for the stream computed as specified in RFC 3550, denoted in ISO 8601 format. For example, 1 second is denoted as 'PT1S', where 'P' is the duration designator, 'T' is the time designator, and 'S' is the second designator.
          format: duration
          nullable: true
        averagePacketLossRate:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Average packet loss rate for stream.
        averageRatioOfConcealedSamples:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Ratio of the number of audio frames with samples generated by packet loss concealment to the total number of audio frames.
        averageReceivedFrameRate:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Average frames per second received for all video streams computed over the duration of the session.
        averageRoundTripTime:
          pattern: ^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$
          type: string
          description: Average network propagation round-trip time computed as specified in RFC 3550, denoted in ISO 8601 format. For example, 1 second is denoted as 'PT1S', where 'P' is the duration designator, 'T' is the time designator, and 'S' is the second designator.
          format: duration
          nullable: true
        averageVideoFrameLossPercentage:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Average percentage of video frames lost as displayed to the user.
        averageVideoFrameRate:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Average frames per second received for a video stream, computed over the duration of the session.
        averageVideoPacketLossRate:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Average fraction of packets lost, as specified in RFC 3550, computed over the duration of the session.
        endDateTime:
          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: UTC time when the stream ended. 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. This field is only available for streams that use the SIP protocol.
          format: date-time
          nullable: true
        isAudioForwardErrorCorrectionUsed:
          type: boolean
          description: Indicates whether the forward error correction (FEC) was used at some point during the session. The default value is null.
          nullable: true
        lowFrameRateRatio:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Fraction of the call where frame rate is less than 7.5 frames per second.
        lowVideoProcessingCapabilityRatio:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Fraction of the call that the client is running less than 70% expected video processing capability.
        maxAudioNetworkJitter:
          pattern: ^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$
          type: string
          description: Maximum of audio network jitter computed over each of the 20 second windows during the session, denoted in ISO 8601 format. For example, 1 second is denoted as 'PT1S', where 'P' is the duration designator, 'T' is the time designator, and 'S' is the second designator.
          format: duration
          nullable: true
        maxJitter:
          pattern: ^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$
          type: string
          description: Maximum jitter for the stream computed as specified in RFC 3550, denoted in ISO 8601 format. For example, 1 second is denoted as 'PT1S', where 'P' is the duration designator, 'T' is the time designator, and 'S' is the second designator.
          format: duration
          nullable: true
        maxPacketLossRate:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Maximum packet loss rate for the stream.
        maxRatioOfConcealedSamples:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Maximum ratio of packets concealed by the healer.
        maxRoundTripTime:
          pattern: ^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$
          type: string
          description: Maximum network propagation round-trip time computed as specified in RFC 3550, denoted in ISO 8601 format. For example, 1 second is denoted as 'PT1S', where 'P' is the duration designator, 'T' is the time designator, and 'S' is the second designator.
          format: duration
          nullable: true
        packetUtilization:
          type: number
          description: Packet count for the stream.
          format: int64
          nullable: true
        postForwardErrorCorrectionPacketLossRate:
          oneOf:
          - type: number
            format: float
            nullable: true
          - type: string
            nullable: true
          - $ref: '#/components/schemas/ReferenceNumeric'
          description: Packet loss rate after FEC has been applied aggregated across all video streams and codecs.
        rmsFreezeDuration:
          pattern: ^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$
          type: string
          description: Average duration of the received freezing time in the video stream represented in 

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