Delete Namespace

curl -X DELETE "http://localhost:8080/namespaces/my-documents"

{
  "status": "success",
  "message": "Namespace delete started. Poll delete job status for progress.",
  "namespace_name": "my-documents",
  "job_id": "job-682efd0be4484e49b7bf787466d6e9a4"
}

{
  "status": "failure",
  "message": "Namespace 'my-documents' not found."
}

DELETE

namespaces

{namespace_name}

curl -X DELETE "http://localhost:8080/namespaces/my-documents"

{
  "status": "success",
  "message": "Namespace delete started. Poll delete job status for progress.",
  "namespace_name": "my-documents",
  "job_id": "job-682efd0be4484e49b7bf787466d6e9a4"
}

{
  "status": "failure",
  "message": "Namespace 'my-documents' not found."
}

Overview

Removes a namespace and every item in it (documents, vectors, uploaded file chunks, summaries). Also clears that namespace from file_registry.json. The operation runs in the background. Use the returned job_id with Delete job status. When the delete job completes, global item quota is freed for all items that were in the namespace.

Files under ~/.moorcheh/uploads are not deleted — only indexed data is removed.

Path parameters

string

required

Name of the namespace to delete.

curl -X DELETE "http://localhost:8080/namespaces/my-documents"

Response fields

string

Request outcome. "success" when the delete job was started; "failure" on error.

string

Human-readable result or error description.

string

Name of the namespace being deleted. Present when the delete job was started.

string

Id of the async delete job. Poll Delete job status with this value. Present when the delete job was started.

{
  "status": "success",
  "message": "Namespace delete started. Poll delete job status for progress.",
  "namespace_name": "my-documents",
  "job_id": "job-682efd0be4484e49b7bf787466d6e9a4"
}

{
  "status": "failure",
  "message": "Namespace 'my-documents' not found."
}

Next Steps

Delete job status — poll until status is completed or failed
List namespaces — confirm the namespace was removed

System

Namespace Management

Search

AI Generation

Data Operations

File storage

Items

Overview

Path parameters

Response fields

Next Steps

​Overview

​Path parameters

​Response fields

​Next Steps

​Related

Overview

Path parameters

Response fields

Next Steps

Related