# Search permissions

Lists all permissions defined in the system, with optional filtering by role.

Request:
roleId       - Optional role ID to return only permissions associated with that role.

Response:
permissions   - List of PermissionItem objects (id, name, description).

Endpoint: POST /api/v1/permission/list-permissions
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `roleId` (string)
    Rule data fields

## Response 200 fields (application/json):

  - `permissions` (array)

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

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

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

## 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)