v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB
Roles

List permissions for role

Retrieves all permissions directly assigned to the specified role, excluding permissions inherited from base roles. Use this endpoint to view the explicit permission assignments for a role, which is useful for understanding direct role capabilities, auditing permission assignments, or managing role-permission relationships. Provide the role name as a path parameter, and the response will include only the permissions that are directly assigned to that role. This operation does not include inherited permissions from role hierarchies - use ListEffectiveRolePermissions to see the complete set of permissions including inheritance. Returns a list of permission objects with their names, descriptions, and assignment metadata.

get/api/v1/roles/{role_name}/permissions

Path parameters

role_namestring required

Name of the role

Response

Successfully retrieved role permissions. Returns a list of all permissions directly assigned to the specified role, excluding inherited permissions.

Example response

{
  "permissions": [
    {
      "is_scalekit_permission": true
    }
  ]
}