# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.SignIns Policies.unified Role Management Policy…
  version: 1.0.0
extends: openapi/azure-ad-policies-unifiedrolemanagementpolicyassignment-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/policies/roleManagementPolicyAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List PIM role management policy assignments
      effect: read
      questions:
      - Which role management policies are assigned to Entra roles and groups in PIM?
      - Can I filter PIM policy assignments by scope or role definition?
      instructions:
      - text: List all role management policy assignments in PIM.
      - text: Show PIM policy assignments matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/roleManagementPolicyAssignments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a role management policy assignment
      effect: write
      questions:
      - Can I link a role management policy to a role definition at a given scope?
      - What does a new PIM policy assignment need, such as policy id, role and scope?
      instructions:
      - text: Assign policy {policy} to role {role} at scope {scope}.
        slots:
          policy: requestBody.policyId
          role: requestBody.roleDefinitionId
          scope: requestBody.scopeId
      - text: Create a PIM policy assignment for role {role} with scope type {scopeType}.
        slots:
          role: requestBody.roleDefinitionId
          scopeType: requestBody.scopeType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/roleManagementPolicyAssignments/{unifiedRoleManagementPolicyAssignment-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a PIM role management policy assignment
      effect: read
      questions:
      - What are the details of one PIM policy assignment for a role or group?
      - Which role and scope is a specific policy assignment tied to?
      instructions:
      - text: Get role management policy assignment {assignment}.
        slots:
          assignment: path.unifiedRoleManagementPolicyAssignment-id
      - text: Show the role, scope and policy of PIM assignment {assignment}.
        slots:
          assignment: path.unifiedRoleManagementPolicyAssignment-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/roleManagementPolicyAssignments/{unifiedRoleManagementPolicyAssignment-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role management policy assignment
      effect: destructive
      questions:
      - Can I remove a PIM policy assignment from a role?
      - What happens if I delete a role management policy assignment?
      instructions:
      - text: Delete role management policy assignment {assignment}.
        slots:
          assignment: path.unifiedRoleManagementPolicyAssignment-id
      - text: Remove PIM policy assignment {assignment}.
        slots:
          assignment: path.unifiedRoleManagementPolicyAssignment-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/roleManagementPolicyAssignments/{unifiedRoleManagementPolicyAssignment-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a role management policy assignment
      effect: write
      questions:
      - Can I point an existing PIM policy assignment at a different policy?
      - Which fields of a role management policy assignment can be changed?
      instructions:
      - text: Change PIM assignment {assignment} to use policy {policy}.
        slots:
          assignment: path.unifiedRoleManagementPolicyAssignment-id
          policy: requestBody.policyId
      - text: Update the scope of policy assignment {assignment} to {scope}.
        slots:
          assignment: path.unifiedRoleManagementPolicyAssignment-id
          scope: requestBody.scopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/roleManagementPolicyAssignments/{unifiedRoleManagementPolicyAssignment-id}/policy'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the policy behind a PIM policy assignment
      effect: read
      questions:
      - Which role management policy and rules does a PIM assignment actually enforce?
      - Can I see the effective rules of the policy linked to an assignment?
      instructions:
      - text: Get the policy linked to PIM assignment {assignment}.
        slots:
          assignment: path.unifiedRoleManagementPolicyAssignment-id
      - text: Show the policy and its rules for assignment {assignment}, expanding {expand}.
        slots:
          assignment: path.unifiedRoleManagementPolicyAssignment-id
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/roleManagementPolicyAssignments/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count role management policy assignments
      effect: read
      questions:
      - How many role management policy assignments exist in PIM?
      - What is the total of PIM policy assignments across roles and groups?
      instructions:
      - text: Count all role management policy assignments.
      - text: Tell me how many PIM policy assignments there are.
      method: generated
      generated: '2026-10-01'