# 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.access Review Set… version: 1.0.0 extends: openapi/azure-ad-identitygovernance-accessreviewset-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: 77 - target: $.paths['/identityGovernance/accessReviews'].get update: x-apievangelist-phrasing: intent: Get the tenant's access review container effect: read questions: - What does the top-level access reviews object in identity governance contain? - Can I expand the review definitions and history definitions from the access review root? instructions: - text: Show me the access reviews root object for our tenant. - text: Fetch the access review set with its definitions expanded. method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews'].delete update: x-apievangelist-phrasing: intent: Delete the access review container effect: destructive questions: - Is it possible to remove the whole access reviews navigation property from identity governance? - What happens if I delete the access review set itself rather than a single definition? instructions: - text: Delete the access reviews container from identity governance. - text: Remove the access review set only if its ETag still matches {etag}. slots: etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews'].patch update: x-apievangelist-phrasing: intent: Update the access review container effect: write questions: - Can I patch the access review set root in one call instead of each definition? - Which collections hang off the access review set that a patch can touch? instructions: - text: Update the access review set root object. - text: 'Patch the access review set with these schedule definitions: {definitions}.' slots: definitions: requestBody.definitions method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions'].get update: x-apievangelist-phrasing: intent: List access review schedule definitions effect: read questions: - Which access review series are set up in our Entra tenant? - Can I filter the access review schedule definitions by status or display name? instructions: - text: List all access review schedule definitions. - text: Show the first {top} access review definitions ordered by {orderby}. slots: top: query.$top orderby: query.$orderby method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions'].post update: x-apievangelist-phrasing: intent: Create a new access review series effect: write questions: - How do I schedule a recurring access review of a group's members? - Can I set fallback reviewers and stage settings when I create an access review? - What do I need to specify to start a new access review schedule definition? instructions: - text: Create an access review called {displayName} scoped to {scope} with reviewers {reviewers}. slots: displayName: requestBody.displayName scope: requestBody.scope reviewers: requestBody.reviewers - text: Set up a new access review series named {displayName} with settings {settings}. slots: displayName: requestBody.displayName settings: requestBody.settings method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}'].get update: x-apievangelist-phrasing: intent: Get one access review schedule definition effect: read questions: - How can I see the scope, reviewers and settings of a specific access review series? - What properties come back when I read a single access review definition? instructions: - text: Get access review definition {definition}. slots: definition: path.accessReviewScheduleDefinition-id - text: Show the reviewers and schedule settings of access review {definition}. slots: definition: path.accessReviewScheduleDefinition-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}'].put update: x-apievangelist-phrasing: intent: Replace an access review schedule definition effect: write questions: - Can I change the reviewers or recurrence of an access review series that already exists? - Is updating an existing access review definition a full replace rather than a patch? instructions: - text: Update access review definition {definition} to use reviewers {reviewers}. slots: definition: path.accessReviewScheduleDefinition-id reviewers: requestBody.reviewers - text: Rename existing access review series {definition} to {displayName}. slots: definition: path.accessReviewScheduleDefinition-id displayName: requestBody.displayName method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}'].delete update: x-apievangelist-phrasing: intent: Delete an access review series effect: destructive questions: - How do I permanently remove an access review series from Entra? - Does deleting an access review schedule definition also get rid of its instances? instructions: - text: Delete access review definition {definition}. slots: definition: path.accessReviewScheduleDefinition-id - text: Remove access review series {definition} if its ETag is {etag}. slots: definition: path.accessReviewScheduleDefinition-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances'].get update: x-apievangelist-phrasing: intent: List occurrences of an access review series effect: read questions: - Which recurrences have run so far for a given access review definition? - Can I filter an access review series' instances by status to find the in-progress one? instructions: - text: List the instances of access review definition {definition}. slots: definition: path.accessReviewScheduleDefinition-id - text: Show instances of review series {definition} matching {filter}. slots: definition: path.accessReviewScheduleDefinition-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances'].post update: x-apievangelist-phrasing: intent: Add an instance to an access review series effect: write questions: - Can I create an access review instance directly under a schedule definition? - What start and end dates can I give a new occurrence of a review series? instructions: - text: Create an instance of access review {definition} starting {startDateTime} and ending {endDateTime}. slots: definition: path.accessReviewScheduleDefinition-id startDateTime: requestBody.startDateTime endDateTime: requestBody.endDateTime - text: Add a new occurrence to review series {definition}. slots: definition: path.accessReviewScheduleDefinition-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}'].get update: x-apievangelist-phrasing: intent: Get one occurrence of an access review effect: read questions: - How do I check the status and dates of one run of an access review? - What does a single access review instance tell me about its scope and reviewers? instructions: - text: Get instance {instance} of access review definition {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show the status of review occurrence {instance} in series {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}'].delete update: x-apievangelist-phrasing: intent: Delete an access review instance effect: destructive questions: - Is it possible to delete one occurrence of an access review without deleting the series? - Can I guard deletion of an access review instance with an ETag? instructions: - text: Delete instance {instance} from access review series {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Remove review occurrence {instance} of {definition} only if the ETag is {etag}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}'].patch update: x-apievangelist-phrasing: intent: Change reviewers on a running access review effect: write questions: - Can I add fallback reviewers to an access review instance that's already in progress? - Why can't I remove existing fallback reviewers from a review instance? - Which fields of an access review instance can actually be updated? instructions: - text: Add fallback reviewers {fallbackReviewers} to review instance {instance} of {definition}, keeping scope {scope}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id fallbackReviewers: requestBody.fallbackReviewers scope: requestBody.scope - text: Set the reviewers of in-progress instance {instance} in series {definition} to {reviewers} with scope {scope}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id reviewers: requestBody.reviewers scope: requestBody.scope method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/contactedReviewers'].get update: x-apievangelist-phrasing: intent: List reviewers contacted for a review instance effect: read questions: - Who were the individual people asked to complete a particular access review run? - Does the contacted reviewer list include people who never got a notification? instructions: - text: List contacted reviewers for instance {instance} of review {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show who was asked to review occurrence {instance} in series {definition}, filtered by {filter}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/contactedReviewers'].post update: x-apievangelist-phrasing: intent: Add a contacted reviewer record to a review effect: write questions: - Can I add an entry to the contacted reviewers of an access review instance? - What fields does a contacted reviewer record take, like user principal name? instructions: - text: Add {userPrincipalName} as a contacted reviewer on instance {instance} of review {definition}. slots: userPrincipalName: requestBody.userPrincipalName definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Record contacted reviewer {displayName} for review occurrence {instance} of {definition}. slots: displayName: requestBody.displayName definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/contactedReviewers/{accessReviewReviewer-id}'].get update: x-apievangelist-phrasing: intent: Get one contacted reviewer of a review effect: read questions: - When a group owner is the reviewer, how do I see which actual person was contacted? - What details are stored for a single contacted reviewer on an access review? instructions: - text: Get contacted reviewer {reviewer} on instance {instance} of review {definition}. slots: reviewer: path.accessReviewReviewer-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show the user principal name of contacted reviewer {reviewer} in occurrence {instance} of {definition}. slots: reviewer: path.accessReviewReviewer-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/contactedReviewers/{accessReviewReviewer-id}'].delete update: x-apievangelist-phrasing: intent: Remove a contacted reviewer from a review effect: destructive questions: - Can I delete a contacted reviewer entry from an access review instance? - Is an ETag check supported when removing a contacted reviewer? instructions: - text: Delete contacted reviewer {reviewer} from instance {instance} of review {definition}. slots: reviewer: path.accessReviewReviewer-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Remove contacted reviewer {reviewer} on occurrence {instance} of {definition} if the ETag is {etag}. slots: reviewer: path.accessReviewReviewer-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/contactedReviewers/{accessReviewReviewer-id}'].patch update: x-apievangelist-phrasing: intent: Update a contacted reviewer record effect: write questions: - Can I correct the display name stored for a contacted reviewer? - Which contacted reviewer fields can be patched on an access review instance? instructions: - text: Change the display name of contacted reviewer {reviewer} on instance {instance} of {definition} to {displayName}. slots: reviewer: path.accessReviewReviewer-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id displayName: requestBody.displayName - text: Update the user principal name of contacted reviewer {reviewer} in review occurrence {instance} of {definition} to {userPrincipalName}. slots: reviewer: path.accessReviewReviewer-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id userPrincipalName: requestBody.userPrincipalName method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/contactedReviewers/$count'].get update: x-apievangelist-phrasing: intent: Count contacted reviewers on a review effect: read questions: - How many people were contacted to complete a given access review instance? - Can I count only the contacted reviewers that match a filter? instructions: - text: Count the contacted reviewers on instance {instance} of review {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Give me the number of contacted reviewers in occurrence {instance} of {definition} matching {filter}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions'].get update: x-apievangelist-phrasing: intent: List decisions in an access review instance effect: read questions: - Which approve and deny decisions have been recorded in an access review run? - Can I filter the decision items of a review instance to only the ones not yet reviewed? instructions: - text: List all decisions for instance {instance} of access review {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show decision items in review occurrence {instance} of {definition} where {filter}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions'].post update: x-apievangelist-phrasing: intent: Add a decision item to a review instance effect: write questions: - Can I create a new decision item directly on an access review instance? - What goes into a decision item, like the principal, resource and justification? instructions: - text: Create a decision item on instance {instance} of review {definition} with decision {decision}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id decision: requestBody.decision - text: Add a decision for principal {principal} on resource {resource} to review occurrence {instance} of {definition}. slots: principal: requestBody.principal resource: requestBody.resource definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/{accessReviewInstanceDecisionItem-id}'].get update: x-apievangelist-phrasing: intent: Get one decision in a review instance effect: read questions: - How do I see who reviewed a specific access decision and what they decided? - What does a single access review decision item include, like its recommendation? instructions: - text: Get decision {decision} from instance {instance} of review {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show the recommendation and outcome of decision {decision} in review occurrence {instance} of {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/{accessReviewInstanceDecisionItem-id}'].delete update: x-apievangelist-phrasing: intent: Delete a decision from a review instance effect: destructive questions: - Can a decision item be deleted from an access review instance? - Is an If-Match ETag honoured when deleting a review decision item? instructions: - text: Delete decision {decision} from instance {instance} of review {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Remove decision item {decision} in occurrence {instance} of {definition} if its ETag matches {etag}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/{accessReviewInstanceDecisionItem-id}'].patch update: x-apievangelist-phrasing: intent: Record a decision on a review instance item effect: write questions: - How do I approve or deny one access decision directly on a review instance? - Can I add a justification when I update an instance-level decision item? instructions: - text: Set decision {decision} on instance {instance} of review {definition} to {outcome} with justification {justification}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id outcome: requestBody.decision justification: requestBody.justification - text: Mark decision item {decision} in review occurrence {instance} of {definition} as {outcome}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id outcome: requestBody.decision method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights'].get update: x-apievangelist-phrasing: intent: List insights behind a review decision effect: read questions: - What recommendations does Entra give reviewers for a specific access decision? - Can a single decision item have more than one governance insight? instructions: - text: Pull the instance-level insights behind decision {decision} of run {instance}, series {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show the approve-or-deny insights attached to decision {decision} of occurrence {instance} in {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights'].post update: x-apievangelist-phrasing: intent: Add an insight to a review decision effect: write questions: - Can I attach a new governance insight to an access review decision item? - What fields does creating a decision insight accept? instructions: - text: Attach an instance-level insight to decision {decision} of run {instance}, series {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Add an insight created at {insightCreatedDateTime} to decision {decision} of occurrence {instance} in {definition}. slots: insightCreatedDateTime: requestBody.insightCreatedDateTime decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights/{governanceInsight-id}'].get update: x-apievangelist-phrasing: intent: Get one insight on a review decision effect: read questions: - How do I read a specific recommendation insight attached to an access decision? - When was a given governance insight on a review decision created? instructions: - text: Read instance-level insight {insight} for decision {decision} of run {instance}, series {definition}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show when insight {insight} for decision {decision} in occurrence {instance} of {definition} was created. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights/{governanceInsight-id}'].delete update: x-apievangelist-phrasing: intent: Delete an insight from a review decision effect: destructive questions: - Can I remove a governance insight from an access review decision item? - Does deleting a decision insight support an ETag precondition? instructions: - text: Drop instance-level insight {insight} attached to decision {decision} of run {instance}, series {definition}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Delete the instance-level insight {insight} for decision {decision}, run {instance}, series {definition}, guarded by ETag {etag}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights/{governanceInsight-id}'].patch update: x-apievangelist-phrasing: intent: Update an insight on a review decision effect: write questions: - Can I patch the creation time of an insight on an access review decision? - Which fields of a decision insight on an instance can be updated? instructions: - text: Patch instance-level insight {insight} for decision {decision} of run {instance}, series {definition}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Set the created time of insight {insight} for decision {decision} in occurrence {instance} of {definition} to {insightCreatedDateTime}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id insightCreatedDateTime: requestBody.insightCreatedDateTime method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights/$count'].get update: x-apievangelist-phrasing: intent: Count insights on a review decision effect: read questions: - How many recommendation insights are attached to one access review decision? - Can I count only the decision insights that match a filter? instructions: - text: Count the insights on decision {decision} in instance {instance} of review {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Give me the number of insights for decision {decision} of occurrence {instance} in {definition} matching {filter}. slots: decision: path.accessReviewInstanceDecisionItem-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/$count'].get update: x-apievangelist-phrasing: intent: Count decisions in an access review instance effect: read questions: - How many decision items does an access review run contain? - Can I count how many decisions in a review instance match a filter such as not reviewed? instructions: - text: Tally all instance-level decision items for run {instance} of series {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Give me the number of decision items in occurrence {instance} of {definition} where {filter}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/decisions/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get update: x-apievangelist-phrasing: intent: List review decisions assigned to me effect: read questions: - Which decisions in an access review instance am I personally the reviewer on? - Can I see only my own pending decision items across a review instance? instructions: - text: List the decisions I need to review in instance {instance} of review {definition}, filtered on {on}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id 'on': path.on - text: Show my decision items as {on} for occurrence {instance} of access review {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id 'on': path.on method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/microsoft.graph.acceptRecommendations'].post update: x-apievangelist-phrasing: intent: Accept all recommendations on a review effect: write questions: - Can I accept every system recommendation for the decisions I haven't reviewed yet? - Is there a one-step way to go with Entra's recommendations on an access review run? instructions: - text: Accept the recommendations on all my unreviewed decisions in instance {instance} of review {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Apply the suggested approve or deny to every pending item I review in occurrence {instance} of {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/microsoft.graph.applyDecisions'].post update: x-apievangelist-phrasing: intent: Apply completed access review decisions effect: write questions: - How do I enforce review decisions when auto-apply was turned off? - Does an access review instance need to be Completed before I can apply its decisions? instructions: - text: Apply the decisions of completed review instance {instance} in series {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Enforce the recorded outcomes for access review occurrence {instance} of {definition} now. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/microsoft.graph.batchRecordDecisions'].post update: x-apievangelist-phrasing: intent: Record review decisions in bulk effect: write questions: - Can I approve or deny many access review items at once by principal or resource? - How do reviewers record decisions in batches instead of one item at a time? instructions: - text: Record {decision} with justification {justification} for all items of principal {principalId} in instance {instance} of review {definition}. slots: decision: requestBody.decision justification: requestBody.justification principalId: requestBody.principalId definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Batch-record {decision} for every item on resource {resourceId} in occurrence {instance} of {definition}. slots: decision: requestBody.decision resourceId: requestBody.resourceId definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/microsoft.graph.resetDecisions'].post update: x-apievangelist-phrasing: intent: Reset all decisions on a review instance effect: destructive questions: - Can I wipe every decision on an access review run back to not reviewed? - What happens to recorded approvals when I reset an access review instance's decisions? instructions: - text: Reset all decisions in instance {instance} of review {definition} to not reviewed. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Clear every recorded outcome on access review occurrence {instance} of {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/microsoft.graph.sendReminder'].post update: x-apievangelist-phrasing: intent: Remind reviewers of an active access review effect: write questions: - How do I nudge reviewers who haven't finished an active access review? - Can I send a reminder email to the reviewers of a running review instance? instructions: - text: Send a reminder to the reviewers of instance {instance} in review {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Nudge everyone reviewing occurrence {instance} of {definition} to finish. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/microsoft.graph.stop'].post update: x-apievangelist-phrasing: intent: Stop an active access review instance effect: destructive questions: - Can I end an in-progress access review run early and apply its decisions? - Will stopping one review instance stop future recurrences of the series? instructions: - text: Stop active review instance {instance} of access review {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: End occurrence {instance} of review series {definition} now so decisions get applied. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages'].get update: x-apievangelist-phrasing: intent: List stages of a multi-stage access review effect: read questions: - What stages does a multi-stage access review instance go through? - Can I filter the stages of a review instance by status? instructions: - text: List the stages of instance {instance} in access review {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show stages of review occurrence {instance} of {definition} matching {filter}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages'].post update: x-apievangelist-phrasing: intent: Add a stage to a review instance effect: write questions: - Can I create a new stage on a multi-stage access review instance? - What start date, end date and reviewers can a new review stage take? instructions: - text: Create a stage on instance {instance} of review {definition} with reviewers {reviewers}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id reviewers: requestBody.reviewers - text: Add a review stage running {startDateTime} to {endDateTime} on occurrence {instance} of {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id startDateTime: requestBody.startDateTime endDateTime: requestBody.endDateTime method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}'].get update: x-apievangelist-phrasing: intent: Get one stage of a multi-stage review effect: read questions: - How do I check the status and dates of a single stage in a multi-stage review? - Who are the reviewers configured for a specific access review stage? instructions: - text: Get stage {stage} of instance {instance} in access review {definition}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show the status and reviewers of stage {stage} in occurrence {instance} of {definition}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}'].delete update: x-apievangelist-phrasing: intent: Delete a stage from a review instance effect: destructive questions: - Can I delete one stage from a multi-stage access review? - Does removing a review stage support an ETag check? instructions: - text: Delete stage {stage} from instance {instance} of review {definition}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Remove review stage {stage} of occurrence {instance} in {definition} if the ETag is {etag}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}'].patch update: x-apievangelist-phrasing: intent: Change reviewers on an access review stage effect: write questions: - Can I add fallback reviewers to a review stage that hasn't finished yet? - Which statuses must a review stage be in before I can update its reviewers? instructions: - text: Add fallback reviewers {fallbackReviewers} to stage {stage} of instance {instance} in review {definition}. slots: fallbackReviewers: requestBody.fallbackReviewers stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Set the reviewers of stage {stage} in occurrence {instance} of {definition} to {reviewers}. slots: reviewers: requestBody.reviewers stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions'].get update: x-apievangelist-phrasing: intent: List decisions within a review stage effect: read questions: - Which decisions were recorded during one stage of a multi-stage access review? - Can I filter a review stage's decision items by outcome? instructions: - text: List decisions in stage {stage} of instance {instance} of review {definition}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show stage {stage} decision items in occurrence {instance} of {definition} where {filter}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions'].post update: x-apievangelist-phrasing: intent: Add a decision item to a review stage effect: write questions: - Can I create a decision item inside a specific stage of an access review? - What principal and resource details does a new stage decision take? instructions: - text: Create a decision on stage {stage} of instance {instance} in review {definition} with outcome {outcome}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id outcome: requestBody.decision - text: Add a stage decision for principal {principal} on resource {resource} in stage {stage} of occurrence {instance}, series {definition}. slots: principal: requestBody.principal resource: requestBody.resource stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/{accessReviewInstanceDecisionItem-id}'].get update: x-apievangelist-phrasing: intent: Get one decision within a review stage effect: read questions: - How do I look up a single decision made during one stage of a multi-stage review? - Who reviewed a particular stage decision item and when? instructions: - text: Get decision {decision} in stage {stage} of instance {instance} of review {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show who reviewed stage {stage} decision {decision} in occurrence {instance} of {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/{accessReviewInstanceDecisionItem-id}'].delete update: x-apievangelist-phrasing: intent: Delete a decision from a review stage effect: destructive questions: - Can I remove a decision item from a specific access review stage? - Is an ETag honoured when deleting a stage decision? instructions: - text: Erase the stage-level decision item {decision} recorded in stage {stage}, run {instance}, series {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Remove stage {stage} decision {decision} of occurrence {instance} in {definition} if the ETag is {etag}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/{accessReviewInstanceDecisionItem-id}'].patch update: x-apievangelist-phrasing: intent: Approve or deny an item in a review stage effect: write questions: - How do I record my approve or deny decision for an item in a multi-stage review? - Can I only update stage decisions where I'm the reviewer? instructions: - text: Set decision {decision} in stage {stage} of instance {instance}, review {definition}, to {outcome} because {justification}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id outcome: requestBody.decision justification: requestBody.justification - text: Approve stage {stage} item {decision} in occurrence {instance} of {definition} as {outcome}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id outcome: requestBody.decision method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights'].get update: x-apievangelist-phrasing: intent: List insights on a stage decision effect: read questions: - What recommendations support a decision item in one stage of a multi-stage review? - Can I page through the insights on a stage-level decision? instructions: - text: List insights for decision {decision} in stage {stage} of instance {instance}, review {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show the recommendation insights on stage {stage} decision {decision} of occurrence {instance} in {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights'].post update: x-apievangelist-phrasing: intent: Add an insight to a stage decision effect: write questions: - Can I attach a governance insight to a decision inside a review stage? - What does creating an insight on a stage decision require? instructions: - text: Create an insight on decision {decision} in stage {stage} of instance {instance}, review {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Add a stage {stage} insight created at {insightCreatedDateTime} to decision {decision} in occurrence {instance} of {definition}. slots: insightCreatedDateTime: requestBody.insightCreatedDateTime decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights/{governanceInsight-id}'].get update: x-apievangelist-phrasing: intent: Get one insight on a stage decision effect: read questions: - How do I read a single insight attached to a decision in a review stage? - When was a particular stage decision insight generated? instructions: - text: Get insight {insight} on decision {decision} in stage {stage} of instance {instance}, review {definition}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Show the creation time of stage {stage} insight {insight} on decision {decision}, occurrence {instance} of {definition}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights/{governanceInsight-id}'].delete update: x-apievangelist-phrasing: intent: Delete an insight from a stage decision effect: destructive questions: - Can I remove an insight from a decision inside an access review stage? - Is an ETag check available when deleting a stage decision insight? instructions: - text: Delete insight {insight} from decision {decision} in stage {stage} of instance {instance}, review {definition}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Remove stage {stage} insight {insight} on decision {decision} of occurrence {instance} in {definition} if the ETag is {etag}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights/{governanceInsight-id}'].patch update: x-apievangelist-phrasing: intent: Update an insight on a stage decision effect: write questions: - Can I patch an insight on a decision within a multi-stage review stage? - Which fields of a stage decision insight are updatable? instructions: - text: Update insight {insight} on decision {decision} in stage {stage} of instance {instance}, review {definition}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Set stage {stage} insight {insight} on decision {decision} (occurrence {instance}, series {definition}) created time to {insightCreatedDateTime}. slots: insight: path.governanceInsight-id decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id insightCreatedDateTime: requestBody.insightCreatedDateTime method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/{accessReviewInstanceDecisionItem-id}/insights/$count'].get update: x-apievangelist-phrasing: intent: Count insights on a stage decision effect: read questions: - How many insights are attached to a decision in one review stage? - Can I count stage decision insights that match a search? instructions: - text: Count insights on decision {decision} in stage {stage} of instance {instance}, review {definition}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Give me the number of stage {stage} insights on decision {decision} in occurrence {instance} of {definition} matching {search}. slots: decision: path.accessReviewInstanceDecisionItem-id stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id search: query.$search method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/$count'].get update: x-apievangelist-phrasing: intent: Count decisions in a review stage effect: read questions: - How many decision items are in one stage of a multi-stage access review? - Can I count a stage's decisions that match a filter? instructions: - text: Count the decisions in stage {stage} of instance {instance}, review {definition}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Give me the number of stage {stage} decisions in occurrence {instance} of {definition} where {filter}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/decisions/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get update: x-apievangelist-phrasing: intent: List my decisions in a review stage effect: read questions: - Which decisions in a specific review stage am I the reviewer for? - Can I see only my own items within one stage of a multi-stage review? instructions: - text: List my decisions in stage {stage} of instance {instance}, review {definition}, filtered on {on}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id 'on': path.on - text: Show the stage {stage} items I review as {on} in occurrence {instance} of {definition}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id 'on': path.on method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/{accessReviewStage-id}/microsoft.graph.stop'].post update: x-apievangelist-phrasing: intent: Stop an in-progress access review stage effect: destructive questions: - Can I end one stage of a multi-stage review early so the next stage starts? - What happens to reviewer input after I stop a review stage? instructions: - text: Stop stage {stage} of instance {instance} in access review {definition}. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: End in-progress stage {stage} of occurrence {instance}, series {definition}, and move to the next stage. slots: stage: path.accessReviewStage-id definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/$count'].get update: x-apievangelist-phrasing: intent: Count stages in a review instance effect: read questions: - How many stages does a given multi-stage review instance have? - Can I count review stages that match a filter? instructions: - text: Count the stages of instance {instance} in review {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id - text: Give me the number of stages in occurrence {instance} of {definition} matching {filter}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/{accessReviewInstance-id}/stages/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get update: x-apievangelist-phrasing: intent: List review stages where I'm a reviewer effect: read questions: - Which stages of a multi-stage review have items waiting on me? - Can I list only the stages of a review instance where I'm assigned as reviewer? instructions: - text: List stages of instance {instance} in review {definition} where I review items, filtered on {on}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id 'on': path.on - text: Show my assigned stages as {on} for occurrence {instance} of {definition}. slots: definition: path.accessReviewScheduleDefinition-id instance: path.accessReviewInstance-id 'on': path.on method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/$count'].get update: x-apievangelist-phrasing: intent: Count instances of an access review series effect: read questions: - How many times has an access review series recurred? - Can I count a review series' instances that match a filter? instructions: - text: Count the instances of access review definition {definition}. slots: definition: path.accessReviewScheduleDefinition-id - text: Give me the number of occurrences of review series {definition} where {filter}. slots: definition: path.accessReviewScheduleDefinition-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/instances/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get update: x-apievangelist-phrasing: intent: List review instances assigned to me effect: read questions: - Which runs of an access review series still have decisions for me to make? - Can I see only the instances of a review series where I'm a reviewer? instructions: - text: List instances of review {definition} where I'm a reviewer, filtered on {on}. slots: definition: path.accessReviewScheduleDefinition-id 'on': path.on - text: Show the occurrences of series {definition} I review as {on}. slots: definition: path.accessReviewScheduleDefinition-id 'on': path.on method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinition-id}/microsoft.graph.stop'].post update: x-apievangelist-phrasing: intent: Stop an access review series effect: destructive questions: - Can I stop a whole access review schedule definition rather than one run? - Is there an action to halt an access review series entirely? instructions: - text: Stop access review series {definition}. slots: definition: path.accessReviewScheduleDefinition-id - text: Halt the schedule definition {definition} for this access review. slots: definition: path.accessReviewScheduleDefinition-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/$count'].get update: x-apievangelist-phrasing: intent: Count access review schedule definitions effect: read questions: - How many access review series exist in our tenant? - Can I count review definitions that match a search term? instructions: - text: Count all access review schedule definitions. - text: Give me the number of access review series matching {search}. slots: search: query.$search method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/definitions/microsoft.graph.filterByCurrentUser(on=\'{on}\')'].get update: x-apievangelist-phrasing: intent: List access review series I review effect: read questions: - Which access review series am I a reviewer on? - Can I list only the review definitions where I have instances to review? instructions: - text: List the access review definitions where I'm a reviewer, filtered on {on}. slots: 'on': path.on - text: Show every review series I participate in as {on}. slots: 'on': path.on method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions'].get update: x-apievangelist-phrasing: intent: List access review history reports effect: read questions: - What access review history reports were created in the last 30 days? - Can I filter review history definitions by status? instructions: - text: List the access review history definitions. - text: Show review history report definitions matching {filter}. slots: filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions'].post update: x-apievangelist-phrasing: intent: Create an access review history report effect: write questions: - How do I export past access review decisions for an audit? - Can I limit a review history report to a date range and certain decisions? instructions: - text: Create a review history report named {displayName} covering {reviewHistoryPeriodStartDateTime} to {reviewHistoryPeriodEndDateTime}. slots: displayName: requestBody.displayName reviewHistoryPeriodStartDateTime: requestBody.reviewHistoryPeriodStartDateTime reviewHistoryPeriodEndDateTime: requestBody.reviewHistoryPeriodEndDateTime - text: Set up an access review history definition for scopes {scopes} including decisions {decisions}. slots: scopes: requestBody.scopes decisions: requestBody.decisions method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}'].get update: x-apievangelist-phrasing: intent: Get an access review history report effect: read questions: - Why does fetching an access review history definition older than 30 days return 404? - What date range and scopes does a given review history report cover? instructions: - text: Get access review history definition {history_definition}. slots: history_definition: path.accessReviewHistoryDefinition-id - text: Show the period and scopes of history report {history_definition}. slots: history_definition: path.accessReviewHistoryDefinition-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}'].delete update: x-apievangelist-phrasing: intent: Delete an access review history report effect: destructive questions: - Can I delete an access review history definition I no longer need? - Does deleting a review history report accept an If-Match ETag? instructions: - text: Delete access review history definition {history_definition}. slots: history_definition: path.accessReviewHistoryDefinition-id - text: Remove history report {history_definition} if its ETag is {etag}. slots: history_definition: path.accessReviewHistoryDefinition-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}'].patch update: x-apievangelist-phrasing: intent: Update an access review history report effect: write questions: - Can I change the name or schedule of an existing access review history report? - Which fields of a review history definition can be patched? instructions: - text: Rename access review history definition {history_definition} to {displayName}. slots: history_definition: path.accessReviewHistoryDefinition-id displayName: requestBody.displayName - text: Change the schedule settings of history report {history_definition} to {scheduleSettings}. slots: history_definition: path.accessReviewHistoryDefinition-id scheduleSettings: requestBody.scheduleSettings method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}/instances'].get update: x-apievangelist-phrasing: intent: List runs of a review history report effect: read questions: - What runs of a recurring access review history report exist? - Can I filter review history instances by status to find ones that are done? instructions: - text: List the instances of history definition {history_definition}. slots: history_definition: path.accessReviewHistoryDefinition-id - text: Show runs of history report {history_definition} where {filter}. slots: history_definition: path.accessReviewHistoryDefinition-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}/instances'].post update: x-apievangelist-phrasing: intent: Add a run to a review history report effect: write questions: - Can I create a new instance of an access review history definition myself? - What period and run time can a new history report instance take? instructions: - text: Create an instance of history definition {history_definition} to run at {runDateTime}. slots: history_definition: path.accessReviewHistoryDefinition-id runDateTime: requestBody.runDateTime - text: Add a history report run to {history_definition} covering {reviewHistoryPeriodStartDateTime} to {reviewHistoryPeriodEndDateTime}. slots: history_definition: path.accessReviewHistoryDefinition-id reviewHistoryPeriodStartDateTime: requestBody.reviewHistoryPeriodStartDateTime reviewHistoryPeriodEndDateTime: requestBody.reviewHistoryPeriodEndDateTime method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}/instances/{accessReviewHistoryInstance-id}'].get update: x-apievangelist-phrasing: intent: Get one run of a review history report effect: read questions: - How do I check whether a particular review history report run has finished? - Does a non-recurring history definition have only one instance? instructions: - text: Get instance {history_instance} of history definition {history_definition}. slots: history_instance: path.accessReviewHistoryInstance-id history_definition: path.accessReviewHistoryDefinition-id - text: Show the status and download link of history run {history_instance} in report {history_definition}. slots: history_instance: path.accessReviewHistoryInstance-id history_definition: path.accessReviewHistoryDefinition-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}/instances/{accessReviewHistoryInstance-id}'].delete update: x-apievangelist-phrasing: intent: Delete a run of a review history report effect: destructive questions: - Can I delete a single run of an access review history report? - Is an ETag check supported when removing a history report instance? instructions: - text: Delete instance {history_instance} of history definition {history_definition}. slots: history_instance: path.accessReviewHistoryInstance-id history_definition: path.accessReviewHistoryDefinition-id - text: Remove history run {history_instance} from report {history_definition} if the ETag is {etag}. slots: history_instance: path.accessReviewHistoryInstance-id history_definition: path.accessReviewHistoryDefinition-id etag: header.If-Match method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}/instances/{accessReviewHistoryInstance-id}'].patch update: x-apievangelist-phrasing: intent: Update a run of a review history report effect: write questions: - Can I change the expiration of a review history report instance? - Which fields on a history report run can be patched? instructions: - text: Set the expiration of history instance {history_instance} in {history_definition} to {expirationDateTime}. slots: history_instance: path.accessReviewHistoryInstance-id history_definition: path.accessReviewHistoryDefinition-id expirationDateTime: requestBody.expirationDateTime - text: Update the status of history run {history_instance} of report {history_definition} to {status}. slots: history_instance: path.accessReviewHistoryInstance-id history_definition: path.accessReviewHistoryDefinition-id status: requestBody.status method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}/instances/{accessReviewHistoryInstance-id}/microsoft.graph.generateDownloadUri'].post update: x-apievangelist-phrasing: intent: Generate a download link for review history effect: write questions: - How do I get a downloadable file of access review history results? - How long is a generated review history download URI valid? instructions: - text: Generate a download URI for history instance {history_instance} of {history_definition}. slots: history_instance: path.accessReviewHistoryInstance-id history_definition: path.accessReviewHistoryDefinition-id - text: Create a 24-hour download link for completed history run {history_instance} in report {history_definition}. slots: history_instance: path.accessReviewHistoryInstance-id history_definition: path.accessReviewHistoryDefinition-id method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/{accessReviewHistoryDefinition-id}/instances/$count'].get update: x-apievangelist-phrasing: intent: Count runs of a review history report effect: read questions: - How many runs does an access review history report have? - Can I count history report instances that match a filter? instructions: - text: Count the instances of history definition {history_definition}. slots: history_definition: path.accessReviewHistoryDefinition-id - text: Give me the number of runs of history report {history_definition} where {filter}. slots: history_definition: path.accessReviewHistoryDefinition-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identityGovernance/accessReviews/historyDefinitions/$count'].get update: x-apievangelist-phrasing: intent: Count access review history reports effect: read questions: - How many access review history definitions do we have? - Can I count review history reports that match a search? instructions: - text: Count all access review history definitions. - text: Give me the number of review history reports matching {search}. slots: search: query.$search method: generated generated: '2026-10-01'