Delete Knowledge Base

curl --request DELETE \
  --url https://prod-api.ringg.ai/ca/api/v0/external/kb/{kb_id} \
  --header 'X-API-KEY: <x-api-key>'

{
  "message": "Knowledge Base deleted successfully",
  "kb_id": "550e8400-e29b-41d4-a716-446655440000"
}

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

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

​

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

​

Alternative: Edit Instead

Consider using 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.