Skip to main content
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"
}

​
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

​
namespace_name
string
required
Name of the namespace to delete.
curl -X DELETE "http://localhost:8080/namespaces/my-documents"

​
Response fields

​
status
string
Request outcome. "success" when the delete job was started; "failure" on error.
​
message
string
Human-readable result or error description.
​
namespace_name
string
Name of the namespace being deleted. Present when the delete job was started.
​
job_id
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"
}

​
Next Steps