List all knowledge bases
Retrieve a paginated list of all knowledge bases accessible to the authenticated user.
Overview:
Returns knowledge bases where the user has at least READER permission. Results include the user's role for each KB.
Filtering:
- search: Full-text search on KB names (max 1000 chars)
- permissions: Filter by user's role (comma-separated: OWNER, WRITER, READER)
Sorting Options:
- name — Alphabetical by KB name
- createdAtTimestamp — By creation date
- updatedAtTimestamp — By last modification
- userRole — By permission level
Performance:
Uses efficient pagination with limit/offset. For large result sets, use smaller page sizes.
Query parameters:
Only page, limit, search, permissions, sortBy, and sortOrder are allowed; unknown query keys are rejected.
Query parameters
Page number (1-indexed). Omitted values default to 1.
Results per page (max 100). Omitted values default to 20.
Search KB names (max 1000 chars). Rejected if it contains HTML/script tags, event handlers, javascript:, or format specifiers (validated in Zod + controller).
Comma-separated permission roles to filter by. Each token must be one of: OWNER, WRITER, READER.
Field to sort by.
Sort direction.
Response
Successful operation