Microsoft Graph employeeExperience.engagementRole API

openapi: 3.2.0
info:
  title: Microsoft Graph Admin Admin.admin Employee Experience.engagement Role 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: employeeExperience.engagementRole
paths:
  /employeeExperience/roles:
    description: Provides operations to manage the roles property of the microsoft.graph.employeeExperience entity.
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph List roles
      description: Get a list of all the roles that can be assigned in Viva Engage.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/employeeexperience-list-roles?view=graph-rest-1.0
      operationId: employeeExperience.ListRoles
      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.engagementRoleCollectionResponse'
        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:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Create new navigation property to roles for employeeExperience
      operationId: employeeExperience.CreateRoles
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.engagementRole'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.engagementRole'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /employeeExperience/roles/{engagementRole-id}:
    description: Provides operations to manage the roles property of the microsoft.graph.employeeExperience entity.
    parameters:
    - name: engagementRole-id
      in: path
      description: The unique identifier of engagementRole
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRole
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Get roles from employeeExperience
      description: A collection of roles in Viva Engage.
      operationId: employeeExperience.GetRoles
      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.engagementRole'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Update the navigation property roles in employeeExperience
      operationId: employeeExperience.UpdateRoles
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.engagementRole'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.engagementRole'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Delete navigation property roles for employeeExperience
      operationId: employeeExperience.DeleteRoles
      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
  /employeeExperience/roles/{engagementRole-id}/members:
    description: Provides operations to manage the members property of the microsoft.graph.engagementRole entity.
    parameters:
    - name: engagementRole-id
      in: path
      description: The unique identifier of engagementRole
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRole
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph List members
      description: Get a list of users with assigned roles in Viva Engage.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/engagementrole-list-members?view=graph-rest-1.0
      operationId: employeeExperience.roles.ListMembers
      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.engagementRoleMemberCollectionResponse'
        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:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Create engagementRoleMember
      description: Create a new engagementRoleMember object that assigns a Viva Engage role to a user.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/engagementrole-post-members?view=graph-rest-1.0
      operationId: employeeExperience.roles.CreateMembers
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.engagementRoleMember'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.engagementRoleMember'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /employeeExperience/roles/{engagementRole-id}/members/{engagementRoleMember-id}:
    description: Provides operations to manage the members property of the microsoft.graph.engagementRole entity.
    parameters:
    - name: engagementRole-id
      in: path
      description: The unique identifier of engagementRole
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRole
    - name: engagementRoleMember-id
      in: path
      description: The unique identifier of engagementRoleMember
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRoleMember
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Get members from employeeExperience
      description: Users that have this role assigned.
      operationId: employeeExperience.roles.GetMembers
      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.engagementRoleMember'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Update the navigation property members in employeeExperience
      operationId: employeeExperience.roles.UpdateMembers
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.engagementRoleMember'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.engagementRoleMember'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Delete engagementRoleMember
      description: Delete a Viva Engage role from a user.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/engagementrole-delete-members?view=graph-rest-1.0
      operationId: employeeExperience.roles.DeleteMembers
      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
  /employeeExperience/roles/{engagementRole-id}/members/{engagementRoleMember-id}/user:
    description: Provides operations to manage the user property of the microsoft.graph.engagementRoleMember entity.
    parameters:
    - name: engagementRole-id
      in: path
      description: The unique identifier of engagementRole
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRole
    - name: engagementRoleMember-id
      in: path
      description: The unique identifier of engagementRoleMember
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRoleMember
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Get user from employeeExperience
      description: The user who has this role assigned.
      operationId: employeeExperience.roles.members.GetUser
      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.user'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /employeeExperience/roles/{engagementRole-id}/members/{engagementRoleMember-id}/user/mailboxSettings:
    parameters:
    - name: engagementRole-id
      in: path
      description: The unique identifier of engagementRole
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRole
    - name: engagementRoleMember-id
      in: path
      description: The unique identifier of engagementRoleMember
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRoleMember
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Get mailboxSettings property value
      description: Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Returned only on $select.
      operationId: employeeExperience.roles.members.user.GetMailboxSettings
      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: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    patch:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Update property mailboxSettings value.
      operationId: employeeExperience.roles.members.user.UpdateMailboxSettings
      requestBody:
        description: New property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /employeeExperience/roles/{engagementRole-id}/members/{engagementRoleMember-id}/user/serviceProvisioningErrors:
    parameters:
    - name: engagementRole-id
      in: path
      description: The unique identifier of engagementRole
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRole
    - name: engagementRoleMember-id
      in: path
      description: The unique identifier of engagementRoleMember
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRoleMember
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Get serviceProvisioningErrors property value
      description: Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object.  Supports $filter (eq, not, for isResolved and serviceInstance).
      operationId: employeeExperience.roles.members.user.ListServiceProvisioningErrors
      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.serviceProvisioningErrorCollectionResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
  /employeeExperience/roles/{engagementRole-id}/members/{engagementRoleMember-id}/user/serviceProvisioningErrors/$count:
    description: Provides operations to count the resources in the collection.
    parameters:
    - name: engagementRole-id
      in: path
      description: The unique identifier of engagementRole
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRole
    - name: engagementRoleMember-id
      in: path
      description: The unique identifier of engagementRoleMember
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRoleMember
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Get the number of the resource
      operationId: employeeExperience.roles.members.user.ServiceProvisioningErrors.GetCount-84b9
      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'
  /employeeExperience/roles/{engagementRole-id}/members/$count:
    description: Provides operations to count the resources in the collection.
    parameters:
    - name: engagementRole-id
      in: path
      description: The unique identifier of engagementRole
      required: true
      schema:
        type: string
      x-ms-docs-key-type: engagementRole
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Get the number of the resource
      operationId: employeeExperience.roles.members.GetCount-732b
      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'
  /employeeExperience/roles/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
      - employeeExperience.engagementRole
      summary: Microsoft Graph Get the number of the resource
      operationId: employeeExperience.roles.GetCount-9f34
      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.listInfo:
      title: listInfo
      required:
      - '@odata.type'
      type: object
      properties:
        contentTypesEnabled:
          type: boolean
          description: If true, indicates that content types are enabled for this list.
          nullable: true
        hidden:
          type: boolean
          description: If true, indicates that the list isn't normally visible in the SharePoint user experience.
          nullable: true
        template:
          type: string
          description: An enumerated value that represents the base list template used in creating the list. Possible values include documentLibrary, genericList, task, survey, announcements, contacts, and more.
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.sizeRange:
      title: sizeRange
      required:
      - '@odata.type'
      type: object
      properties:
        maximumSize:
          maximum: 2147483647
          minimum: -2147483648
          type: number
          description: The maximum size (in kilobytes) that an incoming message must have in order for a condition or exception to apply.
          format: int32
          nullable: true
        minimumSize:
          maximum: 2147483647
          minimum: -2147483648
          type: number
          description: The minimum size (in kilobytes) that an incoming message must have in order for a condition or exception to apply.
          format: int32
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.virtualEventExternalRegistrationInformation:
      title: virtualEventExternalRegistrationInformation
      required:
      - '@odata.type'
      type: object
      properties:
        referrer:
          type: string
          description: A URL or string that represents the location from which the registrant registered. Optional.
          nullable: true
        registrationId:
          type: string
          description: The identifier for a virtualEventExternalRegistrationInformation object. Optional. If set, the maximum supported length is 256 characters.
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.windowsDeviceHealthState:
      title: windowsDeviceHealthState
      enum:
      - clean
      - fullScanPending
      - rebootPending
      - manualStepsPending
      - offlineScanPending
      - critical
      type: string
      description: Computer endpoint protection state
      x-ms-enum-flags:
        isFlags: true
      x-ms-enum:
        name: windowsDeviceHealthState
        modelAsString: false
        values:
        - value: clean
          description: Computer is clean and no action is required
          name: clean
        - value: fullScanPending
          description: Computer is in pending full scan state
          name: fullScanPending
        - value: rebootPending
          description: Computer is in pending reboot state
          name: rebootPending
        - value: manualStepsPending
          description: Computer is in pending manual steps state
          name: manualStepsPending
        - value: offlineScanPending
          description: Computer is in pending offline scan state
          name: offlineScanPending
        - value: critical
          description: Computer is in critical failure state
          name: critical
    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.specialFolder:
      title: specialFolder
      required:
      - '@odata.type'
      type: object
      properties:
        name:
          type: string
          description: The unique identifier for this item in the /drive/special collection
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.workbookIcon:
      title: workbookIcon
      required:
      - '@odata.type'
      type: object
      properties:
        index:
          maximum: 2147483647
          minimum: -2147483648
          type: number
          description: The index of the icon in the given set.
          format: int32
        set:
          type: string
          description: 'The set that the icon is part of. The possible values are: Invalid, ThreeArrows, ThreeArrowsGray, ThreeFlags, ThreeTrafficLights1, ThreeTrafficLights2, ThreeSigns, ThreeSymbols, ThreeSymbols2, FourArrows, FourArrowsGray, FourRedToBlack, FourRating, FourTrafficLights, FiveArrows, FiveArrowsGray, FiveRating, FiveQuarters, ThreeStars, ThreeTriangles, FiveBoxes.'
        '@odata.type':
          type: string
    microsoft.graph.appLogUploadState:
      title: appLogUploadState
      enum:
      - pending
      - completed
      - failed
      - unknownFutureValue
      type: string
      description: AppLogUploadStatus
      x-ms-enum:
        name: appLogUploadState
        modelAsString: false
        values:
        - value: pending
          description: Default. Indicates that request is waiting to be processed or under processing.
          name: pending
        - value: completed
          description: Indicates that request is completed with file uploaded to Azure blob for download.
          name: completed
        - value: failed
          description: Indicates that request is completed with file uploaded to Azure blob for download.
          name: failed
        - value: unknownFutureValue
          description: Evolvable enumeration sentinel value. Do not use.
          name: unknownFutureValue
    microsoft.graph.operationStatus:
      title: operationStatus
      enum:
      - NotStarted
      - Running
      - Completed
      - Failed
      type: string
    microsoft.graph.scopedRoleMembership:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: scopedRoleMembership
        required:
        - '@odata.type'
        type: object
        properties:
          administrativeUnitId:
            type: string
            description: Unique identifier for the administrative unit that the directory role is scoped to
          roleId:
            type: string
            description: Unique identifier for the directory role that the member is in.
          roleMemberInfo:
            $ref: '#/components/schemas/microsoft.graph.identity'
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.scopedRoleMembership'
    microsoft.graph.sensitivityLabel:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: sensitivityLabel
        required:
        - '@odata.type'
        type: object
        properties:
          actionSource:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.labelActionSource'
            - type: object
              nullable: true
          autoTooltip:
            type: string
            nullable: true
          description:
            type: string
            nullable: true
          displayName:
            type: string
            nullable: true
          isDefault:
            type: boolean
            nullable: true
          isEndpointProtectionEnabled:
            type: boolean
            nullable: true
    

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