Delete Namespace

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."
}

{
  "status": "failure",
  "message": "Unauthorized: Invalid API key"
}

{
  "status": "failure",
  "message": "Forbidden"
}

{
  "status": "failure",
  "message": "Namespace 'my-namespace' not found or does not belong to this user."
}

{
  "status": "failure",
  "message": "API request limit reached for Professional plan (1000000 requests). Current usage: 1000000. Please upgrade your subscription for higher limits.",
  "current_usage": 1000000,
  "limit": 1000000
}

{
  "status": "failure",
  "message": "Internal Server Error processing namespace deletion."
}

DELETE

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."
}

{
  "status": "failure",
  "message": "Unauthorized: Invalid API key"
}

{
  "status": "failure",
  "message": "Forbidden"
}

{
  "status": "failure",
  "message": "Namespace 'my-namespace' not found or does not belong to this user."
}

{
  "status": "failure",
  "message": "API request limit reached for Professional plan (1000000 requests). Current usage: 1000000. Please upgrade your subscription for higher limits.",
  "current_usage": 1000000,
  "limit": 1000000
}

{
  "status": "failure",
  "message": "Internal Server Error processing namespace 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

string

required

Your API key for authentication

string

required

Must be application/json

Path Parameters

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."
}

{
  "status": "failure",
  "message": "Unauthorized: Invalid API key"
}

{
  "status": "failure",
  "message": "Forbidden"
}

{
  "status": "failure",
  "message": "Namespace 'my-namespace' not found or does not belong to this user."
}

{
  "status": "failure",
  "message": "API request limit reached for Professional plan (1000000 requests). Current usage: 1000000. Please upgrade your subscription for higher limits.",
  "current_usage": 1000000,
  "limit": 1000000
}

{
  "status": "failure",
  "message": "Internal Server Error processing namespace deletion."
}

Response Fields

string

Status of the deletion request (“success” for accepted deletions)

string

Human-readable confirmation message

string

Name of the namespace being deleted

string

ISO 8601 timestamp when deletion was initiated

string

Estimated ISO 8601 timestamp when deletion will be complete

Deletion Process

Initiate Deletion

The DELETE request starts the namespace deletion process

Background Processing

The system removes all documents/vectors and associated metadata

Storage Cleanup

Storage space is freed and becomes available for new data

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

List Namespaces - View all namespaces before deletion
Create Namespace - Create a new namespace
Delete Data - Delete specific data within a namespace

List Namespaces Search

Getting Started

Namespace Management

Search & Discovery

AI Generation

Data Operations

File storage

Overview

Authentication

Path Parameters

Response Fields

Deletion Process

Important Notes

Best Practices

Use Cases

​Overview

​Authentication

​Path Parameters

​Response Fields

​Deletion Process

​Important Notes

​Best Practices

​Use Cases

​Related Endpoints

Overview

Authentication

Path Parameters

Response Fields

Deletion Process

Important Notes

Best Practices

Use Cases

Related Endpoints