> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ringg.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Knowledge Bases

> Retrieves all knowledge bases for the current workspace. Rate limit: 60 requests per hour per workspace.

## Get All Knowledge Bases

Retrieve a list of all knowledge bases in your workspace with basic information about each one.

<Warning>
  **Rate Limit**: Maximum 60 requests per hour per workspace
</Warning>

## Response Format

Returns an array of knowledge base objects, each containing:

* `kb_id`: Unique identifier
* `kb_name`: Name of the knowledge base
* `type`: Knowledge base type (e.g., "non\_deterministic")
* `created_at`: Creation timestamp

## Use Cases

### Dashboard View

Display all knowledge bases in your application or dashboard:

```javascript theme={null}
const response = await fetch('https://api.ringg.ai/external/kb/all', {
  headers: { 'X-API-KEY': 'your-api-key' }
});
const knowledgeBases = await response.json();
```

### Dropdown Selection

Populate a dropdown for users to select a knowledge base when configuring agents.

### Audit and Management

* Review all knowledge bases in your workspace
* Identify unused or outdated knowledge bases
* Track knowledge base creation dates

## Getting Detailed Information

This endpoint returns only basic information. For detailed content including files, URLs, and FAQs, use [Get Knowledge Base by ID](/api-reference/endpoint/kb/get-knowledge-base-by-id) with a specific `kb_id`.

<Note>
  **Pagination**: Currently, this endpoint returns all knowledge bases. For workspaces with many knowledge bases, consider caching this data to reduce API calls.
</Note>

## Example Response

```json theme={null}
[
  {
    "kb_id": "550e8400-e29b-41d4-a716-446655440000",
    "kb_name": "Product Documentation",
    "type": "non_deterministic",
    "created_at": "2024-12-16T13:03:29.947147+00:00"
  },
  {
    "kb_id": "660e8400-e29b-41d4-a716-446655440001",
    "kb_name": "Customer Support FAQs",
    "type": "non_deterministic",
    "created_at": "2024-12-17T10:15:42.123456+00:00"
  }
]
```


## OpenAPI

````yaml get /external/kb/all
openapi: 3.0.0
info:
  title: Ringg AI API Documentation
  description: >-
    This is the documentation for the Ringg AI APIs. The Ringg AI API follows
    RESTful principles, making it intuitive and easy to integrate with your
    applications. All API requests should be made to the base URL. The API
    accepts and returns data in JSON format. Ensure your requests include the
    appropriate Content-Type header for POST and PATCH requests.
  version: 2.0.0
servers:
  - url: https://prod-api.ringg.ai/ca/api/v0
security: []
tags:
  - name: workspace
    description: Endpoints for managing your workspace.
  - name: agent
    description: Endpoints for managing assistants (agents).
  - name: calling
    description: Endpoints for making and managing calls.
  - name: campaign
    description: Endpoints for managing campaigns.
  - name: analytics
    description: Endpoints for accessing call analytics and performance metrics.
  - name: termination
    description: Endpoints for terminating active calls using different methods.
  - name: knowledgebase
    description: Endpoints for managing knowledge bases.
paths:
  /external/kb/all:
    get:
      tags:
        - knowledgebase
      summary: Get All Knowledge Bases
      description: >-
        Retrieves all knowledge bases for the current workspace. Rate limit: 60
        requests per hour per workspace.
      operationId: getAllKnowledgeBases
      parameters:
        - name: X-API-KEY
          in: header
          description: (Required) Your Ringg AI API key.
          required: true
          schema:
            type: string
            example: 7251cb4b-3373-43a4-844c-b27a1d45e0c9
      responses:
        '200':
          description: List of all knowledge bases retrieved successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    kb_id:
                      type: string
                      example: 550e8400-e29b-41d4-a716-446655440000
                    kb_name:
                      type: string
                      example: Product Documentation
                    type:
                      type: string
                      example: non_deterministic
                    created_at:
                      type: string
                      format: date-time
                      example: '2024-12-16T13:03:29.947147+00:00'
        '401':
          description: Unauthorized - Invalid or missing API key.
        '429':
          description: Rate limit exceeded - Maximum 60 requests per hour.

````