Delete Files

documents.delete_files

Deletes one or more files by name from a text namespace (storage-backed uploads, for example after documents.upload_file). The backend removes the file and associated derived content from the namespace. This is not the same as documents.delete, which removes indexed text documents by ID.

Parameters

str

required

The name of the target text namespace.

list[str]

required

Non-empty list of file names to delete (same names as returned by documents.list_files or used at upload).

Returns: Dict[str, Any] - A dictionary confirming the deletion request. Common response fields include success, message, namespace, and results (each item: file_name, status, message). Keys are snake_case after SDK normalization. Raises: NamespaceNotFound, InvalidInputError, AuthenticationError, APIError, MoorchehError.

Example

Delete Files Example

from moorcheh_sdk import MoorchehClient

with MoorchehClient() as client:
    status = client.documents.delete_files(
        namespace_name="my-faq-documents",
        file_names=["old-report.pdf", "draft-notes.txt"],
    )
    print(status)

Async Example

Delete Files Async Example

import asyncio
from moorcheh_sdk import AsyncMoorchehClient

async def main():
    async with AsyncMoorchehClient() as client:
        status = await client.documents.delete_files(
            namespace_name="my-faq-documents",
            file_names=["old-report.pdf"],
        )
        for row in status.get("results", []):
            print(row["file_name"], row["status"], row.get("message"))

asyncio.run(main())

Complete Example

Complete Delete Files Workflow

from moorcheh_sdk import MoorchehClient

with MoorchehClient() as client:
    namespace = "my-data"
    listing = client.documents.list_files(namespace_name=namespace)
    names = [f["file_name"] for f in listing.get("files", []) if f["file_name"].endswith(".tmp")]
    if names:
        result = client.documents.delete_files(
            namespace_name=namespace,
            file_names=names,
        )
        print(result.get("message"), result.get("results"))

Important Notes

Per-file results: Check results for each file_name; statuses can differ when some files exist and others do not.

Multi-status (207): The API may return 207 when some deletions succeed and others do not; the SDK treats 200 and 207 as success responses.

Irreversible for storage objects: Deleting by file name removes that object from the namespace’s file storage workflow; confirm names before calling.

Best Practices

Delete only names you intend to remove; prefer listing (documents.list_files) to confirm names first
Inspect results and handle not_found (or similar statuses) without treating the whole call as a hard failure
Batch related removals in one call when the API allows your list size
Use documents.delete when you need to remove documents by ID from the text pipeline, not raw file names

Upload File - Upload files via pre-signed flow
List Files - List raw file objects in storage
Fetch Text Data - List ingested text and summary chunks
Search - Query processed content
Delete Data - Remove indexed documents by ID

Getting Started

Namespace Management

Data Operations

File storage

Search & AI

Best Practices

Legacy

documents.delete_files

Parameters

Example

Async Example

Complete Example

Important Notes

Best Practices

​documents.delete_files

​Parameters

​Example

​Async Example

​Complete Example

​Important Notes

​Best Practices

​Related Operations

documents.delete_files

Parameters

Example

Async Example

Complete Example

Important Notes

Best Practices

Related Operations