---
title: "List knowledge bases"
method: GET
path: "/knowledge-bases"
tags: ["Knowledge Bases"]
---

# List knowledge bases

`GET /knowledge-bases`

## Request

- Base URL: `https://api.telvana.com`
- URL: `https://api.telvana.com/knowledge-bases`
- Auth: API key in header `x-api-key`

Retrieve a paginated list of knowledge bases in your workspace. Supports sorting and pagination.

## Query parameters

- `page` integer
- `pageSize` integer
- `sortBy` string
- `sortOrder` 'asc' | 'desc'

## Response `200`

Knowledge bases retrieved successfully

- object
  - `data` object
    - `knowledgeBases` object[]
      - `id` string
      - `workspaceId` string
      - `name` string
      - `description` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `_count` object
        - `documents` integer
        - `agents` integer
    - `pageCount` integer
    - `pageIndex` integer
    - `pageSize` integer
    - `sortBy` string
    - `sortOrder` string

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/telvana/apis/telvana-api.md) · [All operations](https://skmtc.dev/telvana/apis/telvana-api/llms.txt) · [OpenAPI document](https://skmtc.dev/telvana/apis/telvana-api/revisions/a70ff9063cdf?raw)