Microsoft Graph Role Management

Microsoft Graph Role Management provides a unified API to programmatically manage role-based access across Microsoft Entra ID (Azure AD) and supported services like Microsoft 365 and Intune. It lets you list and inspect built-in and custom role definitions, create or update custom roles, and assign roles to users, groups, or service principals at tenant-wide or resource-scoped levels.

OpenAPI Specification

rolemanagement-openapi-original.yml Raw ↑
openapi: 3.1.0
info:
  title: Microsoft Graph Rolemanagement
  description: Needs a description.
paths:
  /policies/roleManagementPolicies:
    description: >-
      Provides operations to manage the roleManagementPolicies property of the
      microsoft.graph.policyRoot entity.
    get:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph List roleManagementPolicies
      description: >-
        Get the details of the policies in PIM that can be applied to Microsoft
        Entra roles or group membership or ownership. To retrieve policies that
        apply to Azure RBAC, use the Azure REST PIM API for role management
        policies.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/policyroot-list-rolemanagementpolicies?view=graph-rest-1.0
      operationId: policies.ListRoleManagementPolicies
      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.unifiedRoleManagementPolicyCollectionResponse
        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:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Create new navigation property to roleManagementPolicies for policies
      operationId: policies.CreateRoleManagementPolicies
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.unifiedRoleManagementPolicy'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.unifiedRoleManagementPolicy
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /policies/roleManagementPolicies/{unifiedRoleManagementPolicy-id}:
    description: >-
      Provides operations to manage the roleManagementPolicies property of the
      microsoft.graph.policyRoot entity.
    get:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Get unifiedRoleManagementPolicy
      description: Retrieve the details of a role management policy.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/unifiedrolemanagementpolicy-get?view=graph-rest-1.0
      operationId: policies.GetRoleManagementPolicies
      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.unifiedRoleManagementPolicy
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Update the navigation property roleManagementPolicies in policies
      operationId: policies.UpdateRoleManagementPolicies
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.unifiedRoleManagementPolicy'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.unifiedRoleManagementPolicy
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Delete navigation property roleManagementPolicies for policies
      operationId: policies.DeleteRoleManagementPolicies
      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
    parameters:
      - name: unifiedRoleManagementPolicy-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicy
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicy
  /policies/roleManagementPolicies/{unifiedRoleManagementPolicy-id}/effectiveRules:
    description: >-
      Provides operations to manage the effectiveRules property of the
      microsoft.graph.unifiedRoleManagementPolicy entity.
    get:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Get effectiveRules from policies
      description: >-
        The list of effective rules like approval rules and expiration rules
        evaluated based on inherited referenced rules. For example, if there is
        a tenant-wide policy to enforce enabling an approval rule, the effective
        rule will be to enable approval even if the policy has a rule to disable
        approval. Supports $expand.
      operationId: policies.roleManagementPolicies.ListEffectiveRules
      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.unifiedRoleManagementPolicyRuleCollectionResponse
        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:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Create new navigation property to effectiveRules for policies
      operationId: policies.roleManagementPolicies.CreateEffectiveRules
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyRule
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyRule
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: unifiedRoleManagementPolicy-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicy
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicy
  /policies/roleManagementPolicies/{unifiedRoleManagementPolicy-id}/effectiveRules/{unifiedRoleManagementPolicyRule-id}:
    description: >-
      Provides operations to manage the effectiveRules property of the
      microsoft.graph.unifiedRoleManagementPolicy entity.
    get:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Get effectiveRules from policies
      description: >-
        The list of effective rules like approval rules and expiration rules
        evaluated based on inherited referenced rules. For example, if there is
        a tenant-wide policy to enforce enabling an approval rule, the effective
        rule will be to enable approval even if the policy has a rule to disable
        approval. Supports $expand.
      operationId: policies.roleManagementPolicies.GetEffectiveRules
      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.unifiedRoleManagementPolicyRule
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Update the navigation property effectiveRules in policies
      operationId: policies.roleManagementPolicies.UpdateEffectiveRules
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyRule
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyRule
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Delete navigation property effectiveRules for policies
      operationId: policies.roleManagementPolicies.DeleteEffectiveRules
      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
    parameters:
      - name: unifiedRoleManagementPolicy-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicy
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicy
      - name: unifiedRoleManagementPolicyRule-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicyRule
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicyRule
  /policies/roleManagementPolicies/{unifiedRoleManagementPolicy-id}/effectiveRules/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Get the number of the resource
      operationId: policies.roleManagementPolicies.effectiveRules.GetCount-5858
      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'
    parameters:
      - name: unifiedRoleManagementPolicy-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicy
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicy
  /policies/roleManagementPolicies/{unifiedRoleManagementPolicy-id}/rules:
    description: >-
      Provides operations to manage the rules property of the
      microsoft.graph.unifiedRoleManagementPolicy entity.
    get:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph List rules (for a role management policy)
      description: >-
        Get the rules or settings defined for a role management policy. The
        rules are a collection of following types that are derived from the
        unifiedRoleManagementPolicyRule object:
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/unifiedrolemanagementpolicy-list-rules?view=graph-rest-1.0
      operationId: policies.roleManagementPolicies.ListRules
      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.unifiedRoleManagementPolicyRuleCollectionResponse
        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:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Create new navigation property to rules for policies
      operationId: policies.roleManagementPolicies.CreateRules
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyRule
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyRule
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: unifiedRoleManagementPolicy-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicy
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicy
  /policies/roleManagementPolicies/{unifiedRoleManagementPolicy-id}/rules/{unifiedRoleManagementPolicyRule-id}:
    description: >-
      Provides operations to manage the rules property of the
      microsoft.graph.unifiedRoleManagementPolicy entity.
    get:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Get unifiedRoleManagementPolicyRule
      description: >-
        Retrieve a rule or settings defined for a role management policy. The
        rule can be one of the following types that are derived from the
        unifiedRoleManagementPolicyRule object:
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/unifiedrolemanagementpolicyrule-get?view=graph-rest-1.0
      operationId: policies.roleManagementPolicies.GetRules
      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.unifiedRoleManagementPolicyRule
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Update unifiedRoleManagementPolicyRule
      description: >-
        Update a rule defined for a role management policy. The rule can be one
        of the following types that are derived from the
        unifiedRoleManagementPolicyRule object: For more information about rules
        for Microsoft Entra roles and examples of updating rules, see the
        following articles:
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/unifiedrolemanagementpolicyrule-update?view=graph-rest-1.0
      operationId: policies.roleManagementPolicies.UpdateRules
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyRule
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyRule
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Delete navigation property rules for policies
      operationId: policies.roleManagementPolicies.DeleteRules
      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
    parameters:
      - name: unifiedRoleManagementPolicy-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicy
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicy
      - name: unifiedRoleManagementPolicyRule-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicyRule
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicyRule
  /policies/roleManagementPolicies/{unifiedRoleManagementPolicy-id}/rules/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Get the number of the resource
      operationId: policies.roleManagementPolicies.rules.GetCount-6c00
      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'
    parameters:
      - name: unifiedRoleManagementPolicy-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicy
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicy
  /policies/roleManagementPolicies/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
        - policies.unifiedRoleManagementPolicy
      summary: Microsoft Graph Get the number of the resource
      operationId: policies.roleManagementPolicies.GetCount-cdca
      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'
  /policies/roleManagementPolicyAssignments:
    description: >-
      Provides operations to manage the roleManagementPolicyAssignments property
      of the microsoft.graph.policyRoot entity.
    get:
      tags:
        - policies.unifiedRoleManagementPolicyAssignment
      summary: Microsoft Graph List roleManagementPolicyAssignments
      description: >-
        Get the details of all role management policy assignments made in PIM
        for Microsoft Entra roles and PIM for Groups.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/policyroot-list-rolemanagementpolicyassignments?view=graph-rest-1.0
      operationId: policies.ListRoleManagementPolicyAssignments
      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.unifiedRoleManagementPolicyAssignmentCollectionResponse
        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:
        - policies.unifiedRoleManagementPolicyAssignment
      summary: >-
        Microsoft Graph Create new navigation property to roleManagementPolicyAssignments for policies
      operationId: policies.CreateRoleManagementPolicyAssignments
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyAssignment
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyAssignment
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /policies/roleManagementPolicyAssignments/{unifiedRoleManagementPolicyAssignment-id}:
    description: >-
      Provides operations to manage the roleManagementPolicyAssignments property
      of the microsoft.graph.policyRoot entity.
    get:
      tags:
        - policies.unifiedRoleManagementPolicyAssignment
      summary: Microsoft Graph Get unifiedRoleManagementPolicyAssignment
      description: >-
        Get the details of a policy assignment in PIM that's assigned to
        Microsoft Entra roles or group membership or ownership.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/unifiedrolemanagementpolicyassignment-get?view=graph-rest-1.0
      operationId: policies.GetRoleManagementPolicyAssignments
      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.unifiedRoleManagementPolicyAssignment
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - policies.unifiedRoleManagementPolicyAssignment
      summary: >-
        Microsoft Graph Update the navigation property roleManagementPolicyAssignments in policies
      operationId: policies.UpdateRoleManagementPolicyAssignments
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyAssignment
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.unifiedRoleManagementPolicyAssignment
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - policies.unifiedRoleManagementPolicyAssignment
      summary: Microsoft Graph Delete navigation property roleManagementPolicyAssignments for policies
      operationId: policies.DeleteRoleManagementPolicyAssignments
      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
    parameters:
      - name: unifiedRoleManagementPolicyAssignment-id
        in: path
        description: The unique identifier of unifiedRoleManagementPolicyAssignment
        required: true
        schema:
          type: string
        x-ms-docs-key-type: unifiedRoleManagementPolicyAssignment
  /policies/roleManagementPolicyAssignments/{unifiedRoleManagementPolicyAssignment-id}/policy:
    description: >-
      Provides operations to manage the policy property of the
      microsoft.graph.unifiedRoleManagementPolicyAssignment entity.
    get:
      tags:
        - policies.unifiedRoleManagementPolicyAssignment
      summary: Microsoft Graph Get policy from policies
      description: >-
        The policy that's associated with a policy assignment. Supports $expand
        and a nested $expand of the rules and effectiveRules relationships for
        the policy.
      operationId: policies.roleManagementPolicyAssignments.GetPolicy
      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.unifiedRoleManagementPolicy
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: unifiedRoleManagementPolicyAssignment-id
        in: path
        description: The unique identifier of uni

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