appConsentRequest resource type
Namespace: microsoft.graph
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 | appConsentRequest collection | Retrieve a collection of appConsentRequest objects and their properties. |
Get | appConsentRequest | Read the properties and relationships of an appConsentRequest object. |
Filter by current user | 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 . |
id | String | The identifier of the app consent request. Required. |
pendingScopes | appConsentRequestScope collection | A list of pending scopes waiting for approval. Required. |
Relationships
Relationship | Type | Description |
---|---|---|
userConsentRequests | userConsentRequest collection | A list of pending user consent requests. Supports $filter (eq ). |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.appConsentRequest",
"appDisplayName": "String",
"appId": "String",
"id": "String (identifier)",
"pendingScopes": [
{
"@odata.type": "microsoft.graph.appConsentRequestScope"
}
]
}