Delete Namespace

namespaces.delete

Removes a namespace and every item in it. The server starts an async delete job; by default the client waits until the job completes so you can safely recreate the same namespace name immediately afterward.

client.namespaces.delete(
    namespace_name: str,
    *,
    wait: bool = True,
    poll_interval: float = 0.2,
    timeout: float = 120.0,
) -> dict[str, Any]

API: DELETE /namespaces/{namespace_name} — see Delete namespace

Parameters

str

required

Name of the namespace to delete.

bool

default:"True"

When True (default), poll the delete job until completed or failed before returning.

float

default:"0.2"

Seconds between delete-job status polls when wait=True.

float

default:"120.0"

Max seconds to wait for job completion when wait=True.

Returns: dict[str, Any] — status, job_id, and when wait=True, final delete job fields (for example delete_job.status). Raises: MoorchehApiError — HTTP 404 when the namespace is not found.

Examples

Delete and Wait (default)

from moorcheh import MoorchehClient

with MoorchehClient("http://localhost:8080") as client:
    resp = client.namespaces.delete("my-documents")
    print(resp["delete_job"]["status"])  # completed

Return Immediately With job_id

from moorcheh import MoorchehClient

with MoorchehClient("http://localhost:8080") as client:
    resp = client.namespaces.delete("my-documents", wait=False)
    job_id = resp["job_id"]
    print(f"Delete job started: {job_id}")

Manual Poll (wait=False)

import time
from moorcheh import MoorchehClient

with MoorchehClient("http://localhost:8080") as client:
    resp = client.namespaces.delete("my-documents", wait=False)
    job_id = resp["job_id"]

    while True:
        job = client.namespaces.delete_job_status("my-documents", job_id)
        if job["status"] in ("completed", "failed"):
            break
        time.sleep(0.5)

Error Handling

Error Handling Example

from moorcheh import MoorchehClient, MoorchehApiError

with MoorchehClient("http://localhost:8080") as client:
    try:
        resp = client.namespaces.delete("my-documents")
    except MoorchehApiError as e:
        if e.status_code == 404:
            print("Namespace not found")
        else:
            raise

Status	Cause
404	Namespace not found

Deleting a namespace frees global item quota for all items that were in it. This cannot be undone.

Delete Job Status — poll delete progress
Create Namespace — add a namespace
API: Delete namespace
CLI: moorcheh namespace-delete

Getting Started

System

Namespace Management

Search

AI Generation

Data Operations

File storage

Items

namespaces.delete

Parameters

Examples

Error Handling

​namespaces.delete

​Parameters

​Examples

​Error Handling

​Related Operations

namespaces.delete

Parameters

Examples

Error Handling

Related Operations