# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.Governance Identity Governance.privileged Access…
  version: 1.0.0
extends: openapi/azure-ad-identitygovernance-privilegedaccessroot-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: 92
- target: $.paths['/identityGovernance/privilegedAccess'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the privileged access root
      effect: read
      questions:
      - What does the privileged access root in identity governance expose?
      - Is PIM for Groups reachable under the privileged access object?
      instructions:
      - text: Show the privileged access root for identity governance.
      - text: Fetch privileged access, expanding {expand}.
        slots:
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the privileged access root
      effect: destructive
      questions:
      - Can I remove the privilegedAccess navigation property from identity governance?
      - Is it possible to delete the whole privileged access container?
      instructions:
      - text: Delete the privileged access root from identity governance.
      - text: Remove privileged access only if its ETag still matches {etag}.
        slots:
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update the privileged access root
      effect: write
      questions:
      - Can I patch the privileged access root object?
      - What can I change on the top-level privileged access object?
      instructions:
      - text: 'Update the privileged access root with this group payload: {group}.'
        slots:
          group: requestBody.group
      - text: Patch the privileged access root in identity governance.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the PIM for Groups container
      effect: read
      questions:
      - Where do I find the groups governed by Privileged Identity Management?
      - What PIM for Groups data sits under privileged access?
      instructions:
      - text: Show the PIM for Groups container under privileged access.
      - text: Get the PIM group container and expand {expand}.
        slots:
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the PIM for Groups container
      effect: destructive
      questions:
      - Can I delete the PIM for Groups navigation property?
      - Is there a way to clear the governed-group container under privileged access?
      instructions:
      - text: Delete the PIM for Groups container.
      - text: Delete the PIM group container if it matches ETag {etag}.
        slots:
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update the PIM for Groups container
      effect: write
      questions:
      - Can I patch the PIM for Groups container in one request?
      - Which collections can I set when updating the PIM group container?
      instructions:
      - text: 'Update the PIM for Groups container with these eligibility schedules: {schedules}.'
        slots:
          schedules: requestBody.eligibilitySchedules
      - text: Replace the container's assignment schedules with {schedules}.
        slots:
          schedules: requestBody.assignmentSchedules
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals'].get
  update:
    x-apievangelist-phrasing:
      intent: List PIM group assignment approvals
      effect: read
      questions:
      - Which approvals exist for PIM group assignment requests?
      - Can I page through group assignment approvals with top and skip?
      instructions:
      - text: List all PIM group assignment approvals.
      - text: List group assignment approvals matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a PIM group assignment approval
      effect: write
      questions:
      - Can I create a new approval object for PIM group assignments?
      - What fields does a new group assignment approval take?
      instructions:
      - text: Create a PIM group assignment approval with stages {stages}.
        slots:
          stages: requestBody.stages
      - text: Add a new assignment approval under PIM for Groups.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/{approval-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a PIM group assignment approval
      effect: read
      questions:
      - How do I look up a single PIM group assignment approval by ID?
      - Can I read one assignment approval and choose which properties come back?
      instructions:
      - text: Get PIM group assignment approval {approval}.
        slots:
          approval: path.approval-id
      - text: Show approval {approval} with only {select}.
        slots:
          approval: path.approval-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/{approval-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a PIM group assignment approval
      effect: destructive
      questions:
      - Can I delete a PIM group assignment approval?
      - Is an ETag needed to remove a specific assignment approval?
      instructions:
      - text: Delete assignment approval {approval}.
        slots:
          approval: path.approval-id
      - text: Remove group assignment approval {approval} if ETag {etag} matches.
        slots:
          approval: path.approval-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/{approval-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a PIM group assignment approval
      effect: write
      questions:
      - Can I change the stages on an existing group assignment approval?
      - Is patching a PIM assignment approval I already have supported?
      instructions:
      - text: Update the stages of assignment approval {approval} to {stages}.
        slots:
          approval: path.approval-id
          stages: requestBody.stages
      - text: Patch PIM group assignment approval {approval}.
        slots:
          approval: path.approval-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/{approval-id}/stages'].get
  update:
    x-apievangelist-phrasing:
      intent: List stages of an assignment approval
      effect: read
      questions:
      - What stages does a PIM group assignment approval go through?
      - Can I filter an approval's stages by status?
      instructions:
      - text: List the stages of approval {approval}.
        slots:
          approval: path.approval-id
      - text: Show stages of approval {approval} matching {filter}.
        slots:
          approval: path.approval-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/{approval-id}/stages'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a stage to an assignment approval
      effect: write
      questions:
      - Can I add a stage to a PIM group assignment approval?
      - What can I set on a new approval stage, like justification or reviewer?
      instructions:
      - text: Add a stage named {name} to approval {approval}.
        slots:
          name: requestBody.displayName
          approval: path.approval-id
      - text: Create a stage on approval {approval} with justification {justification}.
        slots:
          approval: path.approval-id
          justification: requestBody.justification
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/{approval-id}/stages/{approvalStage-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one stage of an assignment approval
      effect: read
      questions:
      - How do I read one stage of an assignment approval?
      - Who reviewed a particular approval stage and when?
      instructions:
      - text: Get stage {stage} of approval {approval}.
        slots:
          stage: path.approvalStage-id
          approval: path.approval-id
      - text: Show the review result of stage {stage} in approval {approval}, selecting {select}.
        slots:
          stage: path.approvalStage-id
          approval: path.approval-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/{approval-id}/stages/{approvalStage-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a stage from an assignment approval
      effect: destructive
      questions:
      - Can I delete a stage from an assignment approval?
      - Is it possible to remove one approval stage by its ID?
      instructions:
      - text: Delete stage {stage} from approval {approval}.
        slots:
          stage: path.approvalStage-id
          approval: path.approval-id
      - text: Remove approval stage {stage} on {approval} if ETag {etag} matches.
        slots:
          stage: path.approvalStage-id
          approval: path.approval-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/{approval-id}/stages/{approvalStage-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Review a stage of an assignment approval
      effect: write
      questions:
      - How do I approve or deny a stage of a PIM group assignment approval?
      - Can I add my justification when reviewing an approval stage?
      instructions:
      - text: Set the review result of stage {stage} on approval {approval} to {result}.
        slots:
          stage: path.approvalStage-id
          approval: path.approval-id
          result: requestBody.reviewResult
      - text: Update stage {stage} of approval {approval} with justification {justification}.
        slots:
          stage: path.approvalStage-id
          approval: path.approval-id
          justification: requestBody.justification
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/{approval-id}/stages/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count stages of an assignment approval
      effect: read
      questions:
      - How many stages does a given assignment approval have?
      - Can I count an approval's stages that match a filter?
      instructions:
      - text: Count the stages on approval {approval}.
        slots:
          approval: path.approval-id
      - text: Count stages of approval {approval} matching {filter}.
        slots:
          approval: path.approval-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count PIM group assignment approvals
      effect: read
      questions:
      - How many PIM group assignment approvals are there?
      - Can I get just the total of assignment approvals without the records?
      instructions:
      - text: Count all PIM group assignment approvals.
      - text: Count assignment approvals where {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentApprovals/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: List my assignment approvals
      effect: read
      questions:
      - Which PIM group assignment approvals are waiting on me?
      - Can I see only the approvals that are in scope for me as a reviewer?
      instructions:
      - text: List the assignment approvals in scope for me as {on}.
        slots:
          'on': path.on
      - text: Show my group assignment approvals as {on}, top {top}.
        slots:
          'on': path.on
          top: query.$top
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances'].get
  update:
    x-apievangelist-phrasing:
      intent: List active PIM group assignment instances
      effect: read
      questions:
      - Who currently has active membership or ownership through PIM for Groups?
      - Can I filter active group assignment instances by group?
      instructions:
      - text: List all active PIM group assignment instances.
      - text: List active assignment instances where {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an active assignment instance
      effect: write
      questions:
      - Can I create an assignment schedule instance record directly?
      - What fields go into a new active assignment instance, like memberType?
      instructions:
      - text: Create an active assignment instance for principal {principal} in group {group}.
        slots:
          principal: requestBody.principalId
          group: requestBody.groupId
      - text: Add an assignment instance with access {access} for group {group}.
        slots:
          access: requestBody.accessId
          group: requestBody.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/{privilegedAccessGroupAssignmentScheduleInstance-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an active assignment instance
      effect: read
      questions:
      - How do I read one active group assignment instance?
      - Which properties can I select on a single active assignment instance?
      instructions:
      - text: Get active assignment instance {instance}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
      - text: Show assignment instance {instance} selecting {select}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/{privilegedAccessGroupAssignmentScheduleInstance-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an active assignment instance
      effect: destructive
      questions:
      - Can I delete an active assignment instance object?
      - Does removing an assignment instance record need an ETag?
      instructions:
      - text: Delete active assignment instance {instance}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
      - text: Remove assignment instance {instance} if ETag {etag} matches.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/{privilegedAccessGroupAssignmentScheduleInstance-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an active assignment instance
      effect: write
      questions:
      - Can I change the member type on an existing active assignment instance?
      - Is patching an active assignment instance supported?
      instructions:
      - text: Update assignment instance {instance} to member type {memberType}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
          memberType: requestBody.memberType
      - text: Patch active assignment instance {instance} with group {group}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
          group: requestBody.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/{privilegedAccessGroupAssignmentScheduleInstance-id}/activatedUsing'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the eligibility behind an active instance
      effect: read
      questions:
      - Which eligibility was used to activate this active assignment instance?
      - Was an active assignment instance activated from an eligible schedule?
      instructions:
      - text: Show the eligibility that activated assignment instance {instance}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
      - text: Get activatedUsing for active instance {instance}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/{privilegedAccessGroupAssignmentScheduleInstance-id}/group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the group of an active assignment instance
      effect: read
      questions:
      - Which group does an active assignment instance grant access to?
      - Can I see the group behind a given active assignment instance?
      instructions:
      - text: Get the group for active assignment instance {instance}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
      - text: Get {select} from the group behind active instance {instance}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/{privilegedAccessGroupAssignmentScheduleInstance-id}/group/serviceProvisioningErrors'].get
  update:
    x-apievangelist-phrasing:
      intent: List group errors for an active instance
      effect: read
      questions:
      - Are there provisioning errors on the group of an active assignment instance?
      - Can I list service provisioning errors for the group behind an assignment instance?
      instructions:
      - text: List provisioning errors on the group of assignment instance {instance}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
      - text: Show group provisioning errors for active instance {instance} matching {filter}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/{privilegedAccessGroupAssignmentScheduleInstance-id}/group/serviceProvisioningErrors/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count group errors for an active instance
      effect: read
      questions:
      - How many provisioning errors does the group of an active assignment instance have?
      - Can I count group provisioning errors for one active assignment instance?
      instructions:
      - text: Count provisioning errors on the group behind assignment instance {instance}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
      - text: Count group errors for active instance {instance} where {filter}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/{privilegedAccessGroupAssignmentScheduleInstance-id}/principal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the principal of an active assignment
      effect: read
      questions:
      - Who is the user or principal on an active assignment instance?
      - Can I see which principal holds a specific active group assignment?
      instructions:
      - text: Get the principal of assignment instance {instance}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
      - text: Show who holds active instance {instance}, selecting {select}.
        slots:
          instance: path.privilegedAccessGroupAssignmentScheduleInstance-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count active PIM group assignment instances
      effect: read
      questions:
      - How many active PIM group assignment instances are there?
      - Can I count active assignment instances matching a filter?
      instructions:
      - text: Count active PIM group assignment instances.
      - text: Count active assignment instances where {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleInstances/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: List my active group assignments
      effect: read
      questions:
      - Which PIM groups am I actively a member or owner of right now?
      - Can I list only my own active assignment instances?
      instructions:
      - text: List my active group assignment instances as {on}.
        slots:
          'on': path.on
      - text: Show my active assignment instances as {on}, ordered by {orderby}.
        slots:
          'on': path.on
          orderby: query.$orderby
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List PIM group assignment requests
      effect: read
      questions:
      - What membership and ownership assignment requests have been made for PIM groups?
      - Can I filter group assignment requests by principal?
      instructions:
      - text: List all PIM group assignment requests.
      - text: List assignment requests matching {filter}, ordered by {orderby}.
        slots:
          filter: query.$filter
          orderby: query.$orderby
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a PIM group assignment
      effect: write
      questions:
      - How do I request membership or ownership of a PIM-governed group?
      - Can I assign a user as a group member through a PIM request?
      instructions:
      - text: Request a group assignment for principal {principal} in group {group} with access {access}.
        slots:
          principal: requestBody.principalId
          group: requestBody.groupId
          access: requestBody.accessId
      - text: Submit an assignment request adding {principal} to group {group}.
        slots:
          principal: requestBody.principalId
          group: requestBody.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a PIM group assignment request
      effect: read
      questions:
      - How do I check a single group assignment request?
      - Which properties can I pull from one assignment request?
      instructions:
      - text: Get assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      - text: Show group assignment request {request} expanding {expand}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a PIM group assignment request
      effect: destructive
      questions:
      - Can I delete a group assignment request record?
      - Does deleting an assignment request require an If-Match ETag?
      instructions:
      - text: Delete group assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      - text: Remove assignment request {request} when ETag is {etag}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a PIM group assignment request
      effect: write
      questions:
      - Can I edit an assignment request after it was submitted?
      - Is it possible to change the target schedule on an assignment request?
      instructions:
      - text: Update assignment request {request} to target schedule {schedule}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
          schedule: requestBody.targetScheduleId
      - text: Patch group assignment request {request} with principal {principal}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
          principal: requestBody.principalId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}/activatedUsing'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the eligibility behind an assignment request
      effect: read
      questions:
      - Which eligibility policy did an assignment request activate against?
      - Was this assignment request an activation of an eligible membership?
      instructions:
      - text: Show the eligibility behind assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      - text: Get activatedUsing for group assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}/group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the group of an assignment request
      effect: read
      questions:
      - Which group is an assignment request for?
      - Can I see the target group of a pending assignment request?
      instructions:
      - text: Get the group targeted by assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      - text: Return just {select} for the group an assignment request {request} targets.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}/group/serviceProvisioningErrors'].get
  update:
    x-apievangelist-phrasing:
      intent: List group errors for an assignment request
      effect: read
      questions:
      - Does the group in an assignment request have provisioning errors?
      - Can I list federated service errors for the group on an assignment request?
      instructions:
      - text: List provisioning errors for the group on assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      - text: Show errors on the requested group for {request}, top {top}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
          top: query.$top
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}/group/serviceProvisioningErrors/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count group errors for an assignment request
      effect: read
      questions:
      - How many provisioning errors are on the group of an assignment request?
      - Can I count provisioning errors tied to an assignment request's group?
      instructions:
      - text: Count provisioning errors for the group on assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      - text: Count errors on the requested group of {request} matching {filter}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}/microsoft.graph.cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a PIM group assignment request
      effect: destructive
      questions:
      - Can I cancel a pending PIM group assignment request?
      - How do I withdraw a membership or ownership request I made?
      instructions:
      - text: Cancel group assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      - text: Withdraw PIM assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}/principal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the principal of an assignment request
      effect: read
      questions:
      - Who is the principal named in an assignment request?
      - Can I see which user an assignment request is for?
      instructions:
      - text: Get the principal on assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      - text: Show who assignment request {request} is for, selecting {select}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequest-id}/targetSchedule'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the schedule an assignment request created
      effect: read
      questions:
      - What schedule did an assignment request create?
      - Can I get the assignment schedule produced by a request?
      instructions:
      - text: Get the target schedule of assignment request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      - text: Show the assignment schedule created by request {request}.
        slots:
          request: path.privilegedAccessGroupAssignmentScheduleRequest-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count PIM group assignment requests
      effect: read
      questions:
      - How many PIM group assignment requests exist?
      - Can I count assignment requests without listing them?
      instructions:
      - text: Count PIM group assignment requests.
      - text: Count assignment requests where {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: List my group assignment requests
      effect: read
      questions:
      - What PIM group assignment requests have I made?
      - Can I see only my own membership or ownership requests?
      instructions:
      - text: List my PIM group assignment requests as {on}.
        slots:
          'on': path.on
      - text: Show my assignment requests as {on}, top {top}.
        slots:
          'on': path.on
          top: query.$top
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules'].get
  update:
    x-apievangelist-phrasing:
      intent: List PIM group assignment schedules
      effect: read
      questions:
      - What assignment schedules exist for PIM-governed groups?
      - Can I sort assignment schedules by a property?
      instructions:
      - text: List all PIM group assignment schedules.
      - text: List assignment schedules sorted by {orderby}.
        slots:
          orderby: query.$orderby
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a PIM group assignment schedule
      effect: write
      questions:
      - Can I create an assignment schedule object directly?
      - Which values can I set on a new assignment schedule, such as assignmentType?
      instructions:
      - text: Create an assignment schedule for {principal} on group {group}.
        slots:
          principal: requestBody.principalId
          group: requestBody.groupId
      - text: Add an assignment schedule with type {type} and access {access}.
        slots:
          type: requestBody.assignmentType
          access: requestBody.accessId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/{privilegedAccessGroupAssignmentSchedule-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a PIM group assignment schedule
      effect: read
      questions:
      - How do I read one PIM group assignment schedule?
      - Can I expand related objects when fetching an assignment schedule?
      instructions:
      - text: Get assignment schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
      - text: Show assignment schedule {schedule} expanding {expand}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/{privilegedAccessGroupAssignmentSchedule-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a PIM group assignment schedule
      effect: destructive
      questions:
      - Can I delete a PIM group assignment schedule?
      - Is an ETag check possible when removing an assignment schedule?
      instructions:
      - text: Delete assignment schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
      - text: Remove assignment schedule {schedule} only if ETag {etag} matches.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/{privilegedAccessGroupAssignmentSchedule-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a PIM group assignment schedule
      effect: write
      questions:
      - Can I change the assignment type on an assignment schedule?
      - Is patching an assignment schedule supported?
      instructions:
      - text: Update assignment schedule {schedule} to type {type}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
          type: requestBody.assignmentType
      - text: Patch assignment schedule {schedule} with member type {memberType}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
          memberType: requestBody.memberType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/{privilegedAccessGroupAssignmentSchedule-id}/activatedUsing'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the eligibility behind an assignment schedule
      effect: read
      questions:
      - Which eligibility relationship activated this assignment schedule?
      - Did an assignment schedule come from activating an eligible membership?
      instructions:
      - text: Show the eligibility that activated schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
      - text: Get activatedUsing on assignment schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/{privilegedAccessGroupAssignmentSchedule-id}/group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the group of an assignment schedule
      effect: read
      questions:
      - Which group does an assignment schedule cover?
      - Can I read the group scoped by an assignment schedule?
      instructions:
      - text: Get the group for assignment schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
      - text: Fetch {select} from the group assignment schedule {schedule} applies to.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/{privilegedAccessGroupAssignmentSchedule-id}/group/serviceProvisioningErrors'].get
  update:
    x-apievangelist-phrasing:
      intent: List group errors for an assignment schedule
      effect: read
      questions:
      - Are there provisioning errors on an assignment schedule's group?
      - Can I list service errors for the group of an assignment schedule?
      instructions:
      - text: List provisioning errors on the group of assignment schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
      - text: Show assignment schedule {schedule} group errors that match {filter}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/{privilegedAccessGroupAssignmentSchedule-id}/group/serviceProvisioningErrors/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count group errors for an assignment schedule
      effect: read
      questions:
      - How many provisioning errors does an assignment schedule's group have?
      - Can I count group errors for an assignment schedule?
      instructions:
      - text: Count provisioning errors on the group behind assignment schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
      - text: Count errors matching {filter} on the group of assignment schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/{privilegedAccessGroupAssignmentSchedule-id}/principal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the principal of an assignment schedule
      effect: read
      questions:
      - Which principal is covered by an assignment schedule?
      - Can I see who an assignment schedule grants membership to?
      instructions:
      - text: Get the principal of assignment schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
      - text: Show who schedule {schedule} covers, selecting {select}.
        slots:
          schedule: path.privilegedAccessGroupAssignmentSchedule-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count PIM group assignment schedules
      effect: read
      questions:
      - How many PIM group assignment schedules are there?
      - Can I count assignment schedules that match a filter?
      instructions:
      - text: Count PIM group assignment schedules.
      - text: Count assignment schedules where {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/assignmentSchedules/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: List my group assignment schedules
      effect: read
      questions:
      - What assignment schedules do I have for PIM groups?
      - Can I list just my own group assignment schedules?
      instructions:
      - text: List my group assignment schedules as {on}.
        slots:
          'on': path.on
      - text: Show my assignment schedules as {on}, selecting {select}.
        slots:
          'on': path.on
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances'].get
  update:
    x-apievangelist-phrasing:
      intent: List PIM group eligibility instances
      effect: read
      questions:
      - Who is currently eligible for membership or ownership of PIM groups?
      - Can I filter eligibility instances by principal?
      instructions:
      - text: List all PIM group eligibility instances.
      - text: List eligibility instances where {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a group eligibility instance
      effect: write
      questions:
      - Can I create an eligibility schedule instance record?
      - What fields go into a new eligibility instance, like eligibilityScheduleId?
      instructions:
      - text: Create an eligibility instance for principal {principal} in group {group}.
        slots:
          principal: requestBody.principalId
          group: requestBody.groupId
      - text: Add an eligibility instance tied to schedule {schedule}.
        slots:
          schedule: requestBody.eligibilityScheduleId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances/{privilegedAccessGroupEligibilityScheduleInstance-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a group eligibility instance
      effect: read
      questions:
      - How do I read one eligibility instance for a PIM group?
      - Which properties can I select on a single eligibility instance?
      instructions:
      - text: Get eligibility instance {instance}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
      - text: Show eligibility instance {instance} selecting {select}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances/{privilegedAccessGroupEligibilityScheduleInstance-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a group eligibility instance
      effect: destructive
      questions:
      - Can I delete an eligibility instance object?
      - Does removing an eligibility instance need an ETag?
      instructions:
      - text: Delete eligibility instance {instance}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
      - text: Remove eligibility instance {instance} if ETag {etag} matches.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances/{privilegedAccessGroupEligibilityScheduleInstance-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a group eligibility instance
      effect: write
      questions:
      - Can I switch an eligibility instance between member and owner?
      - Is patching an eligibility instance supported?
      instructions:
      - text: Update eligibility instance {instance} to member type {memberType}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
          memberType: requestBody.memberType
      - text: Patch eligibility instance {instance} with group {group}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
          group: requestBody.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances/{privilegedAccessGroupEligibilityScheduleInstance-id}/group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the group of an eligibility instance
      effect: read
      questions:
      - Which group does an eligibility instance make someone eligible for?
      - Can I read the group behind an eligibility instance?
      instructions:
      - text: Get the group for eligibility instance {instance}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
      - text: Show the group scoped by eligibility instance {instance}, selecting {select}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances/{privilegedAccessGroupEligibilityScheduleInstance-id}/group/serviceProvisioningErrors'].get
  update:
    x-apievangelist-phrasing:
      intent: List group errors for an eligibility instance
      effect: read
      questions:
      - Are there provisioning errors on the group of an eligibility instance?
      - Can I list service provisioning errors for an eligibility instance's group?
      instructions:
      - text: List provisioning errors on the group of eligibility instance {instance}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
      - text: Show group provisioning errors for eligibility instance {instance} matching {filter}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances/{privilegedAccessGroupEligibilityScheduleInstance-id}/group/serviceProvisioningErrors/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count group errors for an eligibility instance
      effect: read
      questions:
      - How many provisioning errors does the group of an eligibility instance have?
      - Can I count group provisioning errors for one eligibility instance?
      instructions:
      - text: Count provisioning errors on the group behind eligibility instance {instance}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
      - text: Count group errors for eligibility instance {instance} where {filter}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances/{privilegedAccessGroupEligibilityScheduleInstance-id}/principal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the principal of an eligibility instance
      effect: read
      questions:
      - Who is the principal on an eligibility instance?
      - Can I see which principal is eligible through a specific eligibility instance?
      instructions:
      - text: Get the principal of eligibility instance {instance}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
      - text: Show who is eligible via instance {instance}, selecting {select}.
        slots:
          instance: path.privilegedAccessGroupEligibilityScheduleInstance-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count PIM group eligibility instances
      effect: read
      questions:
      - How many PIM group eligibility instances are there?
      - Can I count eligibility instances matching a filter?
      instructions:
      - text: Count PIM group eligibility instances.
      - text: Count eligibility instances where {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleInstances/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: List my group eligibility instances
      effect: read
      questions:
      - Which PIM groups am I currently eligible to join or own?
      - Can I list only my own eligibility instances?
      instructions:
      - text: List my group eligibility instances as {on}.
        slots:
          'on': path.on
      - text: Show my eligibility instances as {on}, ordered by {orderby}.
        slots:
          'on': path.on
          orderby: query.$orderby
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List PIM group eligibility requests
      effect: read
      questions:
      - What eligibility requests have been made for PIM-governed groups?
      - Can I filter group eligibility requests by principal?
      instructions:
      - text: List all PIM group eligibility requests.
      - text: List eligibility requests matching {filter}, ordered by {orderby}.
        slots:
          filter: query.$filter
          orderby: query.$orderby
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests'].post
  update:
    x-apievangelist-phrasing:
      intent: Request PIM group eligibility
      effect: write
      questions:
      - How do I make a user eligible for membership of a PIM group?
      - Can I grant eligible ownership of a group through a PIM request?
      instructions:
      - text: Request eligibility for principal {principal} in group {group} with access {access}.
        slots:
          principal: requestBody.principalId
          group: requestBody.groupId
          access: requestBody.accessId
      - text: Submit an eligibility request making {principal} eligible for group {group}.
        slots:
          principal: requestBody.principalId
          group: requestBody.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/{privilegedAccessGroupEligibilityScheduleRequest-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a PIM group eligibility request
      effect: read
      questions:
      - What's the status of a single group eligibility request?
      - Which properties can I pull from one eligibility request?
      instructions:
      - text: Get eligibility request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      - text: Show eligibility request {request} expanding {expand}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/{privilegedAccessGroupEligibilityScheduleRequest-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a PIM group eligibility request
      effect: destructive
      questions:
      - Can I delete a group eligibility request record?
      - Does deleting an eligibility request require an If-Match ETag?
      instructions:
      - text: Delete group eligibility request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      - text: Remove eligibility request {request} when ETag is {etag}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/{privilegedAccessGroupEligibilityScheduleRequest-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a PIM group eligibility request
      effect: write
      questions:
      - Can I edit an eligibility request after submitting it?
      - Can I point an eligibility request at a different target schedule?
      instructions:
      - text: Update eligibility request {request} to target schedule {schedule}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
          schedule: requestBody.targetScheduleId
      - text: Patch group eligibility request {request} with principal {principal}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
          principal: requestBody.principalId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/{privilegedAccessGroupEligibilityScheduleRequest-id}/group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the group of an eligibility request
      effect: read
      questions:
      - Which group is an eligibility request for?
      - Can I see the target group of an eligibility request?
      instructions:
      - text: Get the group targeted by eligibility request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      - text: Show the group on eligibility request {request} with only {select}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/{privilegedAccessGroupEligibilityScheduleRequest-id}/group/serviceProvisioningErrors'].get
  update:
    x-apievangelist-phrasing:
      intent: List group errors for an eligibility request
      effect: read
      questions:
      - Does the group in an eligibility request have provisioning errors?
      - Which service provisioning errors are reported for an eligibility request's group?
      instructions:
      - text: List provisioning errors for the group on eligibility request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      - text: Show errors on the requested group for eligibility request {request}, top {top}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
          top: query.$top
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/{privilegedAccessGroupEligibilityScheduleRequest-id}/group/serviceProvisioningErrors/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count group errors for an eligibility request
      effect: read
      questions:
      - What's the provisioning error count for an eligibility request's group?
      - Can I count provisioning errors tied to an eligibility request's group?
      instructions:
      - text: Count provisioning errors for the group on eligibility request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      - text: Count errors on the requested group of eligibility request {request} matching {filter}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/{privilegedAccessGroupEligibilityScheduleRequest-id}/microsoft.graph.cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a PIM group eligibility request
      effect: destructive
      questions:
      - Can I cancel a pending PIM group eligibility request?
      - How do I withdraw an eligibility request I submitted?
      instructions:
      - text: Cancel group eligibility request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      - text: Withdraw PIM eligibility request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/{privilegedAccessGroupEligibilityScheduleRequest-id}/principal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the principal of an eligibility request
      effect: read
      questions:
      - Who is the principal named in an eligibility request?
      - Can I see which user an eligibility request would make eligible?
      instructions:
      - text: Get the principal on eligibility request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      - text: Show who eligibility request {request} is for, selecting {select}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/{privilegedAccessGroupEligibilityScheduleRequest-id}/targetSchedule'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the schedule an eligibility request created
      effect: read
      questions:
      - What eligibility schedule did a request create?
      - Can I get the schedule produced by an eligibility request?
      instructions:
      - text: Get the target schedule of eligibility request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      - text: Show the eligibility schedule created by request {request}.
        slots:
          request: path.privilegedAccessGroupEligibilityScheduleRequest-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count PIM group eligibility requests
      effect: read
      questions:
      - How many PIM group eligibility requests exist?
      - Can I count eligibility requests without listing them?
      instructions:
      - text: Count PIM group eligibility requests.
      - text: Count eligibility requests where {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilityScheduleRequests/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: List my group eligibility requests
      effect: read
      questions:
      - What PIM group eligibility requests have I made?
      - Can I see only my own eligibility requests for groups?
      instructions:
      - text: List my PIM group eligibility requests as {on}.
        slots:
          'on': path.on
      - text: Show my eligibility requests as {on}, top {top}.
        slots:
          'on': path.on
          top: query.$top
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules'].get
  update:
    x-apievangelist-phrasing:
      intent: List PIM group eligibility schedules
      effect: read
      questions:
      - What eligibility schedules exist for PIM-governed groups?
      - Can I sort eligibility schedules by a property?
      instructions:
      - text: List all PIM group eligibility schedules.
      - text: List eligibility schedules sorted by {orderby}.
        slots:
          orderby: query.$orderby
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a PIM group eligibility schedule
      effect: write
      questions:
      - Can I create an eligibility schedule object directly?
      - Which values can I set on a new eligibility schedule, such as memberType?
      instructions:
      - text: Create an eligibility schedule for {principal} on group {group}.
        slots:
          principal: requestBody.principalId
          group: requestBody.groupId
      - text: Add an eligibility schedule with member type {memberType} and access {access}.
        slots:
          memberType: requestBody.memberType
          access: requestBody.accessId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules/{privilegedAccessGroupEligibilitySchedule-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a PIM group eligibility schedule
      effect: read
      questions:
      - Where can I read one PIM group eligibility schedule?
      - Can I expand related objects when fetching an eligibility schedule?
      instructions:
      - text: Get eligibility schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
      - text: Show eligibility schedule {schedule} expanding {expand}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules/{privilegedAccessGroupEligibilitySchedule-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a PIM group eligibility schedule
      effect: destructive
      questions:
      - Can I delete a PIM group eligibility schedule?
      - Is an ETag check possible when removing an eligibility schedule?
      instructions:
      - text: Delete eligibility schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
      - text: Remove eligibility schedule {schedule} only if ETag {etag} matches.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules/{privilegedAccessGroupEligibilitySchedule-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a PIM group eligibility schedule
      effect: write
      questions:
      - Can I change the member type on an eligibility schedule?
      - Is patching an eligibility schedule supported?
      instructions:
      - text: Update eligibility schedule {schedule} to member type {memberType}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
          memberType: requestBody.memberType
      - text: Patch eligibility schedule {schedule} with group {group}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
          group: requestBody.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules/{privilegedAccessGroupEligibilitySchedule-id}/group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the group of an eligibility schedule
      effect: read
      questions:
      - Which group does an eligibility schedule cover?
      - Can I read the group scoped by an eligibility schedule?
      instructions:
      - text: Get the group for eligibility schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
      - text: Show the scoped group of eligibility schedule {schedule}, selecting {select}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules/{privilegedAccessGroupEligibilitySchedule-id}/group/serviceProvisioningErrors'].get
  update:
    x-apievangelist-phrasing:
      intent: List group errors for an eligibility schedule
      effect: read
      questions:
      - Are there provisioning errors on an eligibility schedule's group?
      - Can I list service errors for the group of an eligibility schedule?
      instructions:
      - text: List provisioning errors on the group of eligibility schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
      - text: Show group provisioning errors for eligibility schedule {schedule} matching {filter}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules/{privilegedAccessGroupEligibilitySchedule-id}/group/serviceProvisioningErrors/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count group errors for an eligibility schedule
      effect: read
      questions:
      - How many provisioning errors does an eligibility schedule's group have?
      - Can I count group errors for an eligibility schedule?
      instructions:
      - text: Count provisioning errors on the group behind eligibility schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
      - text: Count group errors for eligibility schedule {schedule} where {filter}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules/{privilegedAccessGroupEligibilitySchedule-id}/principal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the principal of an eligibility schedule
      effect: read
      questions:
      - Which principal is covered by an eligibility schedule?
      - Can I see who an eligibility schedule makes eligible?
      instructions:
      - text: Get the principal of eligibility schedule {schedule}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
      - text: Show who eligibility schedule {schedule} covers, selecting {select}.
        slots:
          schedule: path.privilegedAccessGroupEligibilitySchedule-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count PIM group eligibility schedules
      effect: read
      questions:
      - How many PIM group eligibility schedules are there?
      - Can I count eligibility schedules that match a filter?
      instructions:
      - text: Count PIM group eligibility schedules.
      - text: Count eligibility schedules where {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identityGovernance/privilegedAccess/group/eligibilitySchedules/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: List my group eligibility schedules
      effect: read
      questions:
      - What eligibility schedules do I have for PIM groups?
      - Can I list just my own group eligibility schedules?
      instructions:
      - text: List my group eligibility schedules as {on}.
        slots:
          'on': path.on
      - text: Show my eligibility schedules as {on}, selecting {select}.
        slots:
          'on': path.on
          select: query.$select
      method: generated
      generated: '2026-10-01'