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

# Delete Knowledge Base

> Deletes a knowledge base by its ID. Rate limit: 10 requests per minute per workspace.

## Delete Knowledge Base

Permanently delete a knowledge base and all its associated content including files, URLs, and FAQs.

<Warning>
  **Permanent Action**:

  * This operation cannot be undone
  * All associated content will be permanently deleted
  * Agents using this knowledge base will lose access to its content
  * Rate limit: Maximum 10 requests per minute per workspace
</Warning>

## Before Deleting

Consider these steps before deleting a knowledge base:

1. **Check Agent Dependencies**: Verify no active agents are using this knowledge base
2. **Backup Important Content**: Download or note any critical information
3. **Review Usage**: Check if the knowledge base is referenced in any campaigns

## Response

On successful deletion, you'll receive:

* `message`: Confirmation message
* `kb_id`: ID of the deleted knowledge base

## Common Use Cases

* **Cleanup**: Remove test or outdated knowledge bases
* **Reorganization**: Delete before recreating with updated structure
* **Resource Management**: Free up workspace resources

<Note>
  **Agent Impact**: If agents are actively using this knowledge base, they will immediately lose access. Update agent configurations before deletion to avoid disruptions.
</Note>

## Alternative: Edit Instead

Consider using [Edit Knowledge Base](/api-reference/endpoint/kb/edit-knowledge-base) instead if you only need to:

* Remove specific files or URLs
* Update content
* Add new information

Editing preserves the knowledge base ID and agent associations.


## OpenAPI

````yaml delete /external/kb/{kb_id}
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/{kb_id}:
    delete:
      tags:
        - knowledgebase
      summary: Delete Knowledge Base
      description: >-
        Deletes a knowledge base by its ID. Rate limit: 10 requests per minute
        per workspace.
      operationId: deleteKnowledgeBase
      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
        - name: kb_id
          in: path
          description: (Required) ID of the knowledge base to delete
          required: true
          schema:
            type: string
            example: 550e8400-e29b-41d4-a716-446655440000
      responses:
        '200':
          description: Knowledge base deleted successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Knowledge Base deleted successfully
                  kb_id:
                    type: string
                    example: 550e8400-e29b-41d4-a716-446655440000
        '401':
          description: Unauthorized - Invalid or missing API key.
        '404':
          description: Knowledge base not found.
        '429':
          description: Rate limit exceeded - Maximum 10 requests per minute.

````