Skip to content

Check Role's Machine Access

Given a list of machine identifiers and a list of role names (or IDs), return a list of MachineAccessResponses (one per each unique role ID/name and machine combo) indicating if each role has access to each machine.

Verb POST
Endpoint {base-url}/roles/machine-access
Max Page Size 50

Request Body

{
  "requestFilter": {
    "machineIdentifiers": ["3283"]
  },
  "routeFilter": {
    "roleIdentifiers": [4]
  }
}

Filters Honored

Returns

On Success

A list of role to machine mappings with a boolean indicating if that role can access that machine.

Response Body

[
  {
    "roleName": "name",
    "roleId": 0,
    "prose": "PROSE012346789", // will be null if you specified an id for this machine
    "machineId": 0, // will always be present
    "canAccess": false
  }
]