Organisation Roles

List the permissions of a role

GET/roles/{id}/permissions
roles:readread_role_permissionsRead-only

Returns every permission the role grants, each with id, key and label, ordered by id. An unknown role returns 404. The add and replace calls return the same set.

Path parameters

  • idintegerRequired#

    The role's id, a whole number from 1 to 2147483647. An unknown role, another organisation's role and a service role return 404.

Responses

200

Every permission the role grants.

RolePermission[]
{
  "data": [
    {
      "id": 1,
      "key": "string",
      "label": "string"
    }
  ]
}
401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl https://your-org-domain/kong/core/api/v2/roles/{id}/permissions\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"