Unassign Roles from Machines

Unassign one or more roles from one or more machines. All roles and machines must be in the same organization.

Verb	POST
Endpoint	{base-url}/roles/remove/machine
Max Page Size	N/A

Request Body

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

Filters Honored

• RequestFilter
  • machineIdentifiers
• PermissionsFilter
  • roleIdentifiers

Note

All changes in this request are atomic. If any item fails, the entire batch is rolled back and no changes are made.

Returns

On Success

Response Body

// 204 - No Content

On Error

HTTP Code	Error Code	Definition
403	DATA_ACCESS_VIOLATION	One or more of the specified machines or roles does not belong to an organization you have access to.
403	DATA_ACCESS_VIOLATION	The specified machines and roles do not all belong to the same organization.
404	MISSING_RECORD	One or more of the specified machines or roles does not exist.