Skip to main content
DELETE
/
v1
/
namespaces
/
{namespace_name}
curl -X DELETE "https://api.moorcheh.ai/v1/namespaces/my-old-documents" \
  -H "x-api-key: your-api-key-here"

{
  "status": "pending",
  "message": "Request accepted. Namespace 'my-documents' has been queued for deletion."
}

​
Overview

Permanently delete a namespace and all its contained documents or vectors. This operation is irreversible and will free up storage space in your account.
This action is permanent and cannot be undone. All data in the namespace will be lost forever.

​
Authentication

​
x-api-key
string
required
Your API key for authentication
​
Content-Type
string
required
Must be application/json

​
Path Parameters

​
namespace_name
string
required
The name of the namespace to delete
curl -X DELETE "https://api.moorcheh.ai/v1/namespaces/my-old-documents" \
  -H "x-api-key: your-api-key-here"

{
  "status": "pending",
  "message": "Request accepted. Namespace 'my-documents' has been queued for deletion."
}

​
Response Fields

​
status
string
Status of the deletion request (“success” for accepted deletions)
​
message
string
Human-readable confirmation message
​
namespace_name
string
Name of the namespace being deleted
​
deletion_started_at
string
ISO 8601 timestamp when deletion was initiated
​
estimated_completion
string
Estimated ISO 8601 timestamp when deletion will be complete

​
Deletion Process

1

Initiate Deletion

The DELETE request starts the namespace deletion process
2

Background Processing

The system removes all documents/vectors and associated metadata
3

Storage Cleanup

Storage space is freed and becomes available for new data
4

Index Updates

Search indexes and internal references are updated

​
Important Notes

  • Deletion is processed asynchronously and may take several minutes for large namespaces
  • You can continue using other namespaces while deletion is in progress
  • Storage quota is updated once deletion is complete
  • Deleted namespace names become available for reuse after completion

​
Best Practices

  • Backup Important Data: Export or backup critical data before deletion
  • Verify Namespace Name: Double-check the namespace name before deletion
  • Monitor Usage: Use the list namespaces endpoint to confirm deletion completion
  • Plan Downtime: Consider impact on applications using the namespace

​
Use Cases

  • Data Cleanup: Remove old or unused namespaces to free up storage
  • Project Completion: Delete namespaces for completed projects
  • Resource Management: Manage namespace limits by removing unused ones
  • Data Lifecycle: Implement data retention policies