Get Role

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.


Authentication
This operation uses the following authentication methods.
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"
    }
}
status
Required

status

response
Optional

response