fix: accept 202 for namespace delete to match server response

The server returns 202 Accepted for DELETE /namespaces/{name} because
cleanup of classes, aliases, and namespaced users completes
asynchronously. The client was declaring ok_in=[204], so successful
deletions surfaced as errors even though the server-side delete went
through. Align the status code with the spec and document the async
behaviour, and update the mock test accordingly.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: jfrancoa

mock_tests/test_namespaces.py

@@ -194,12 +194,12 @@ def test_namespaces_list_all_handles_empty_array(
 # ---------------------------------------------------------------------------
 
 
-def test_namespaces_delete_accepts_204(
+def test_namespaces_delete_accepts_202(
     ns_client: Tuple[weaviate.WeaviateClient, HTTPServer],
 ) -> None:
     client, server = ns_client
     server.expect_request("/v1/namespaces/myns", method="DELETE").respond_with_response(
-        Response(status=204)
+        Response(status=202)
     )
 
     # Must not raise; returns None.

weaviate/namespaces/base.py

@@ -86,6 +86,10 @@ def resp(res: Response) -> List[Namespace]:
     def delete(self, *, name: str) -> executor.Result[None]:
         """Delete a namespace.
 
+        The server marks the namespace for deletion and cleans up its classes,
+        aliases, and users asynchronously, so this call returns as soon as the
+        deletion has been accepted (HTTP 202), not when cleanup has finished.
+
         Args:
             name: The name of the namespace to delete.
         """
@@ -99,5 +103,5 @@ def resp(res: Response) -> None:
             method=self._connection.delete,
             path=f"/namespaces/{name}",
             error_msg=f"Could not delete namespace '{name}'",
-            status_codes=_ExpectedStatusCodes(ok_in=[204], error="Delete namespace"),
+            status_codes=_ExpectedStatusCodes(ok_in=[202], error="Delete namespace"),
         )