List programControls (deprecated)
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.
Caution
This version of the access review API is deprecated and will stop returning data on May 19, 2023. Please use access reviews API.
In the Azure AD access reviews feature, list all the programControl objects, across all programs in the tenant.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | ProgramControl.Read.All, ProgramControl.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | ProgramControl.Read.All, ProgramControl.ReadWrite.All |
The signed in user must also be in a directory role that permits them to read a program.
HTTP request
GET /programControls
Request headers
Name | Type | Description |
---|---|---|
Authorization | string | Bearer {token}. Required. |
Request body
No request body should be supplied.
Response
If successful, this method returns a 200, OK
response code and an array of programControl objects in the response body.
Example
Request
GET https://graph.microsoft.com/beta/programControls
Response
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "f6abf8ef-a05e-4788-adc9-5af909c400af",
"controlId": "bc81d51d-be53-4606-a8c2-f90a2beb5f40",
"programId": "673a7379-9c38-4f01-bd9d-4fda7260b807",
"controlTypeId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
"displayName": "guest user review",
"status": "Completed",
"createdDateTime": "2017-09-20T20:18:05.1318394Z"
}
]
}
See also
Method | Return Type | Description |
---|---|---|
List programControls of a program | programControl collection | Get a collection of the controls of a program. |
Feedback
Submit and view feedback for