Get KB collection API

Applies to:

Retrieves a collection of RBAC device groups.

Permissions

User needs read permissions.

HTTP request

GET /testwdatppreview/machinegroups

Request headers

Header Value
Authorization Bearer {token}. Required.
Content type application/json

Request body

Empty

Response

If successful - 200 OK.

Example

Request

Here is an example of the request.

GET https://graph.microsoft.com/testwdatppreview/machinegroups
Content-type: application/json

Response

Here is an example of the response. Field id contains device group id and equal to field rbacGroupId in devices info. Field ungrouped is true only for one group for all devices that have not been assigned to any group. This group as usual has name "UnassignedGroup".

HTTP/1.1 200 OK
Content-type: application/json
{
    "@odata.context":"https://graph.microsoft.com/testwdatppreview/$metadata#MachineGroups",
    "@odata.count":7,
    "value":[
        {
            "id":86,
            "name":"UnassignedGroup",
            "description":"",
            "ungrouped":true},
        …
}