GET /api/v3/roles/:role_key
Fetch information for a role

Returns details of the role requested

Params

Param name Description
pretty
optional

Return a pretty formatted response if true, Default is false


Value: Must be a Boolean
is_oem
optional

Show role of child account if is_oem flag is true.


Value: Must be one of: <code>true</code>, <code>false</code>, <code>true</code>, <code>false</code>.

Examples

Request - get details of the specified role (role specified as a part of the url)
  curl -X GET  -H "Content-Type:application/json" -H "X-Auth-Token:WtUFnj8pvSxVnH9e_xkq7A"  https://api.datonis.io/api/v3/roles/d5552947a8

Response (returns details of the role requested)
{
  "role": {
    "abilities": [
      3
    ],
    "account_admin": false,
    "role_key": "d5552947a8",
    "name": "Agent",
    "permissions": [
      {
        "class": "thing",
        "operation": "read",
        "seqno": 1
      },
      {
        "class": "thing",
        "operation": "update",
        "seqno": 3
      },
      {
        "class": "sensor",
        "operation": "read",
        "seqno": 1
      },
      {
        "class": "sensor",
        "operation": "update",
        "seqno": 3
      }
    ],
    "created_at": 1448282945,
    "updated_at": 1448282945
  }
}