Skip to content

Delete Roles

Deletes the specified roles.

Verb DELETE
Endpoint {base-url}/roles/
Max Page Size N/A

Request Body

{
  "routeFilter": {
    "roleIdentifiers": [4]
  }
}

Filters Honored

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 roles belongs to an organization you do not have access to.
404 MISSING_RECORD One or more of the specified role IDs does not exist. (An unrecognized role name is ignored rather than treated as missing.)