Microsoft Entra ID (formerly Azure AD) Identity Governance.app Consent Approval Route API
The identityGovernance.appConsentApprovalRoute API from Microsoft Entra ID (formerly Azure AD) — 13 operation(s) for identitygovernance.appconsentapprovalroute.
Operations 26
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
GET
/identityGovernance/appConsent
Get the app consent approval container · Get appConsent from identityGovernance
#
Ask an LLM
“What sits under the app consent section of identity governance?”
“Can I read the admin consent workflow root object in one call?”
Tell an agent
Show the identity governance appConsent object.
Get the app consent approval route root.
PATCH
/identityGovernance/appConsent
Update the app consent approval container · Update the navigation property appConsent in identityGovernance
#
Ask an LLM
“How do I patch the appConsent root under identity governance?”
“Can I replace the set of consent requests held on the appConsent object?”
Tell an agent
Update the identity governance appConsent root with requests {requests}.
Patch the app consent approval container.
DELETE
/identityGovernance/appConsent
Delete the app consent approval container · Delete navigation property appConsent for identityGovernance
#
Ask an LLM
“Is it possible to remove the whole appConsent navigation property from identity governance?”
“Can I delete the app consent root only if its etag still matches?”
Tell an agent destructive · confirm first
Delete the appConsent property from identity governance.
Remove the app consent root with etag {etag}.
GET
/identityGovernance/appConsent/appConsentRequests
List admin consent requests for apps · List appConsentRequests
#
Ask an LLM
“Which apps have users asked an admin to approve access for?”
“Can I filter the pending admin consent requests by app name?”
Tell an agent
List all app consent requests in the tenant.
Find app consent requests matching {filter}.
POST
/identityGovernance/appConsent/appConsentRequests
Create an app consent request · Create new navigation property to appConsentRequests for identityGovernance
#
Ask an LLM
“How do I open a new admin consent request for an app?”
“Can I record which scopes are still pending when creating a consent request?”
Tell an agent
Create a consent request for app {app_id} named {app_name}.
Open an app consent request for {app_id} with pending scopes {scopes}.
GET
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}
Get an app consent request · Get appConsentRequest
#
Ask an LLM
“Which scopes are pending on one specific app consent request?”
“Can I read a single admin consent request by its ID?”
Tell an agent
Show app consent request {request_id}.
Get the app and pending scopes on consent request {request_id}.
PATCH
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}
Update an app consent request · Update the navigation property appConsentRequests in identityGovernance
#
Ask an LLM
“How do I change the pending scopes on an existing app consent request?”
“Can I rename the app shown on a consent request that's already open?”
Tell an agent
Set the pending scopes on consent request {request_id} to {scopes}.
Change the app display name on consent request {request_id} to {app_name}.
DELETE
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}
Delete an app consent request · Delete navigation property appConsentRequests for identityGovernance
#
Ask an LLM
“How do I get rid of an app consent request that's no longer needed?”
“Can I delete a consent request only if nobody changed it since I read it?”
Tell an agent destructive · confirm first
Delete app consent request {request_id}.
Remove consent request {request_id} if its etag is {etag}.
GET
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests
List user requests under an app consent request · List userConsentRequests
#
Ask an LLM
“Who asked for consent to a particular app, and why?”
“Can I filter the individual user requests on an app consent request by status?”
Tell an agent
List the user consent requests for app consent request {request_id}.
Show user requests on {request_id} matching {filter}.
POST
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests
Add a user's request to an app consent request · Create new navigation property to userConsentRequests for identityGovernance
#
Ask an LLM
“How do I file a user's request for access to an app with a justification?”
“Can I attach a reason when adding a user consent request?”
Tell an agent
Add a user consent request to {request_id} with reason {reason}.
Create a new user request under app consent request {request_id}.
GET
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}
Get one user's consent request · Get userConsentRequest
#
Ask an LLM
“What reason did a user give when requesting consent for an app?”
“Can I read one user consent request and its status by ID?”
Tell an agent
Show user consent request {user_request_id} on app request {request_id}.
Get the reason and status of user request {user_request_id} under {request_id}.
PATCH
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}
Update a user's consent request · Update the navigation property userConsentRequests in identityGovernance
#
Ask an LLM
“How do I change the justification on a user's consent request?”
“Can I edit a user consent request after it was submitted?”
Tell an agent
Change the reason on user request {user_request_id} under {request_id} to {reason}.
Update user consent request {user_request_id} on app request {request_id}.
DELETE
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}
Delete a user's consent request · Delete navigation property userConsentRequests for identityGovernance
#
Ask an LLM
“How do I withdraw one person's request for app consent?”
“Can I delete a single user request without deleting the whole app consent request?”
Tell an agent destructive · confirm first
Delete user consent request {user_request_id} from app request {request_id}.
Remove user request {user_request_id} under {request_id} if the etag is {etag}.
GET
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}/approval
Get the approval decision on a user consent request · Get approval from identityGovernance
#
Ask an LLM
“Was a user's app consent request approved or denied?”
“Can I see the approval object behind a single user consent request?”
Tell an agent
Show the approval for user request {user_request_id} on {request_id}.
Get the approval decision attached to consent request {user_request_id} in {request_id}.
PATCH
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}/approval
Update the approval on a user consent request · Update the navigation property approval in identityGovernance
#
Ask an LLM
“How do I change the stages defined on a consent approval?”
“Can I patch the approval object for one user's app consent request?”
Tell an agent
Update the approval stages for user request {user_request_id} on {request_id} to {stages}.
Patch the approval on consent request {user_request_id} under {request_id}.
DELETE
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}/approval
Delete the approval on a user consent request · Delete navigation property approval for identityGovernance
#
Ask an LLM
“How do I clear the approval object from a user's consent request?”
“Can I delete an approval record while keeping the user request itself?”
Tell an agent destructive · confirm first
Delete the approval on user request {user_request_id} under {request_id}.
Remove approval from {user_request_id} in app request {request_id} with etag {etag}.
GET
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}/approval/stages
List the stages of a consent approval · Get stages from identityGovernance
#
Ask an LLM
“What review stages does a user's consent approval go through?”
“Can I see which approval stages are still in progress for a request?”
Tell an agent
List approval stages for user request {user_request_id} on {request_id}.
Show stages of the approval on {user_request_id} in {request_id} matching {filter}.
POST
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}/approval/stages
Add a stage to a consent approval · Create new navigation property to stages for identityGovernance
#
Ask an LLM
“How do I add a review stage to a consent approval?”
“Can I record a reviewer's result and justification when creating a stage?”
Tell an agent
Add an approval stage named {name} to user request {user_request_id} on {request_id}.
Create a stage on {user_request_id} in {request_id} with result {result} and justification {justification}.
GET
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}/approval/stages/{approvalStage-id}
Get one stage of a consent approval · Get stages from identityGovernance
#
Ask an LLM
“Who reviewed a particular approval stage and when?”
“Can I read the status of a single stage in a consent approval?”
Tell an agent
Show approval stage {stage_id} on user request {user_request_id} in {request_id}.
Get reviewer and result for stage {stage_id} of {user_request_id} under {request_id}.
PATCH
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}/approval/stages/{approvalStage-id}
Record a decision on a consent approval stage · Update the navigation property stages in identityGovernance
#
Ask an LLM
“How do I approve or deny a stage of a user's app consent request?”
“Can I add a justification when I record my review decision on a stage?”
Tell an agent
Set review result {result} on stage {stage_id} of {user_request_id} in {request_id}.
Update stage {stage_id} on {user_request_id} under {request_id} with justification {justification}.
DELETE
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}/approval/stages/{approvalStage-id}
Delete a stage from a consent approval · Delete navigation property stages for identityGovernance
#
Ask an LLM
“How do I remove a review stage from a user's consent approval?”
“Can I delete an approval stage guarded by an etag check?”
Tell an agent destructive · confirm first
Delete approval stage {stage_id} from user request {user_request_id} on {request_id}.
Remove stage {stage_id} of {user_request_id} in {request_id} if its etag is {etag}.
GET
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/{userConsentRequest-id}/approval/stages/$count
Count stages in a consent approval · Get the number of the resource
#
Ask an LLM
“How many review stages does one consent approval have?”
“What's the number of approval stages matching a filter for a user request?”
Tell an agent
Count approval stages for user request {user_request_id} on {request_id}.
Count stages on {user_request_id} in {request_id} that match {filter}.
GET
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/$count
Count user requests on an app consent request · Get the number of the resource
#
Ask an LLM
“How many users have requested consent for a given app?”
“What number of user consent requests on an app match a filter?”
Tell an agent
Count user consent requests under app request {request_id}.
Count user requests on {request_id} matching {filter}.
GET
/identityGovernance/appConsent/appConsentRequests/{appConsentRequest-id}/userConsentRequests/microsoft.graph.filterByCurrentUser(on='{on}')
List user consent requests I review for an app · Invoke function filterByCurrentUser
#
Ask an LLM
“Which user requests for one app am I the reviewer on?”
“Can I see only the user consent requests assigned to me for a specific app?”
Tell an agent
List user requests on app consent request {request_id} where I am the {on}.
Show consent requests for {request_id} filtered to the current user as {on}.
GET
/identityGovernance/appConsent/appConsentRequests/$count
Count app consent requests · Get the number of the resource
#
Ask an LLM
“How many admin consent requests for apps are there in total?”
“What's the count of app consent requests matching a search?”
Tell an agent
Count all app consent requests.
Count app consent requests that match {term}.
GET
/identityGovernance/appConsent/appConsentRequests/microsoft.graph.filterByCurrentUser(on='{on}')
List in-progress app consent requests I review · Invoke function filterByCurrentUser
#
Ask an LLM
“Which app consent requests are waiting on me as reviewer?”
“Can I list only the apps whose consent requests are in progress and assigned to me?”
Tell an agent
List app consent requests where I am the {on} and the review is in progress.
Show apps awaiting my consent decision as {on}.