appConsentRequest resource type
Namespace: microsoft.graph
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents the request that a user creates when they request the tenant admin for consent to access an app or to grant permissions to an app. The details include the app that the user wants access to be granted to on their behalf and the permissions that the user is requesting.
The user can create a consent request when an app or a permission requires admin authorization and only when the admin consent workflow is enabled.
Methods
Method | Return type | Description |
---|---|---|
List appConsentRequests | appConsentRequest collection | Retrieve a collection of appConsentRequest objects and their properties. |
Get appConsentRequest | appConsentRequest | Read the properties and relationships of an appConsentRequest object. |
filterByCurrentUser | appConsentRequest | Read the properties of appConsentRequest objects for which the current user is the reviewer and the status of the user consent request is InProgress . |
Properties
Property | Type | Description |
---|---|---|
appDisplayName | String | The display name of the app for which consent is requested. Required. Supports $filter (eq only) and $orderby . |
appId | String | The identifier of the application. Required. Supports $filter (eq only) and $orderby . |
consentType | String | The consent type of the request. Possible values are: Static and Dynamic . These represent static and dynamic permissions, respectively, requested in the consent workflow. Supports $filter (eq only) and $orderby . Required. |
id | String | The identifier of the app consent request. Required. |
pendingScopes | appConsentRequestScope collection | A list of pending scopes waiting for approval. This is empty if the consentType is Static . Required. |
Relationships
Relationship | Type | Description |
---|---|---|
userConsentRequests | userConsentRequest collection | A list of pending user consent requests. Supports $filter (eq ). |
JSON representation
The following is a JSON representation of the resource.
{
"@odata.type": "#microsoft.graph.appConsentRequest",
"id": "String (identifier)",
"appId": "String",
"appDisplayName": "String",
"consentType": "String",
"pendingScopes": [
{
"@odata.type": "microsoft.graph.appConsentRequestScope"
}
]
}
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for