Core
API v1.x
1

You are currently looking at the documentation of a previous version of Kuzzle. We strongly recommend that you use the latest version. You can also use the version selector in the top menu.

getRole #

Gets a security role.


Query Syntax #

HTTP #

URL: http://kuzzle:7512/roles/<_id>
Method: GET

Other protocols #

{
  "controller": "security",
  "action": "getRole",
  "_id": "<roleId>"
}

Arguments #

  • _id: role identifier

Response #

Returns the queried role:

  • _id: role identifier
  • _source: role description
{
  "status": 200,
  "error": null,
  "result": {
    "_id": "<roleId>",
    "_source": {
      "controllers": {
        "*": {
          "actions": true
        }
      }
    }
  },
  "action": "getRole",
  "controller": "security",
  "requestId": "<unique request identifier>"
}