# Search roles

Lists roles within the organization, with optional filtering by type or disabled status.

Request:
includeDisabled  - When true, includes disabled roles in the results.
roleType         - Optional filter to return only USER_ROLE or GROUP_ROLE roles.

Response:
roles             - List of RoleItem objects including id, name, type, description,
permissionIds, and whether the role is a system role.

Endpoint: POST /api/v1/role/list-roles
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `includeDisabled` (boolean)

  - `roleType` (integer)
    Enum: 0, 1

## Response 200 fields (application/json):

  - `roles` (array)

  - `roles.id` (string)
    Rule data fields

  - `roles.name` (string)
    Rule data fields

  - `roles.roleType` (integer)
    Enum: 0, 1

  - `roles.description` (string)
    Rule data fields

  - `roles.permissionIds` (array)

  - `roles.systemRole` (boolean)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)