Get Role
Returns the details of a role with a given ID. The response includes assigned groups and accounts, management properties, permissions, name, description, and the time of the last update and who has done it.
Request
URI
GET
https://{api_host}/api/v2/role/{id}
COPY
Path Parameters
string
id
Required
The ID of the role to get. If you don't know the role's ID, run the Get all roles
API call to return all roles and their IDs.
Responses
200
successful operation
Returns ResponseContainerRoleDTO of type(s) application/json
{
"status": {
"result": "string",
"message": "string",
"code": 0
},
"response": {
"sampleLinkedGroups": [
"UserGroup Object"
],
"linkedGroupsCount": 0,
"sampleLinkedAccounts": [
"string"
],
"linkedAccountsCount": 0,
"restrictedPermissions": [
"string"
],
"properties": {
"nameEditable": false,
"usersRemovable": false,
"usersAddable": false,
"permsEditable": false,
"deletable": false
},
"permissions": [
"string"
],
"name": "string",
"id": "string",
"description": "string",
"createdEpochMillis": 0,
"lastUpdatedMs": 0,
"lastUpdatedAccountId": "string",
"customer": "string"
}
}