OpenAPI 3.1.1Apache 2.02026-08-14108281579.9 KB

452bb34b7e0a

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
    }
  ]
}