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."
}
Namespace Management
Delete Namespace
Delete a namespace and all of its items. Runs asynchronously; poll the delete job for progress.
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 fromfile_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
curl -X DELETE "http://localhost:8080/namespaces/my-documents"
Response fields
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
statusiscompletedorfailed - List namespaces — confirm the namespace was removed
Related
Was this page helpful?