Delete images from workspace

Author: digaobarbosa

docs/index.md

@@ -126,6 +126,18 @@ Or from the CLI:
 roboflow search-export "class:person" -f coco -d my-project -l ./my-export
 ```
 
+### Delete Workspace Images
+
+Delete orphan images (not in any project) from your workspace:
+
+```python
+workspace = rf.workspace()
+
+# Delete orphan images by ID
+result = workspace.delete_images(["image_id_1", "image_id_2"])
+print(f"Deleted: {result['deletedSources']}, Skipped: {result['skippedSources']}")
+```
+
 ### Upload with Metadata
 
 Attach custom key-value metadata to images during upload:

roboflow/adapters/rfapi.py

@@ -239,6 +239,31 @@ def workspace_search(
     return response.json()
 
 
+def workspace_delete_images(
+    api_key: str,
+    workspace_url: str,
+    image_ids: List[str],
+) -> dict:
+    """Delete orphan images from a workspace.
+
+    Args:
+        api_key: Roboflow API key.
+        workspace_url: Workspace slug/url.
+        image_ids: List of image IDs to delete.
+
+    Returns:
+        Parsed JSON response with deletion counts.
+
+    Raises:
+        RoboflowError: On non-200 response status codes.
+    """
+    url = f"{API_URL}/{workspace_url}/images?api_key={api_key}"
+    response = requests.delete(url, json={"images": image_ids})
+    if response.status_code != 200:
+        raise RoboflowError(response.text)
+    return response.json()
+
+
 def upload_image(
     api_key,
     project_url,

roboflow/core/workspace.py

@@ -707,6 +707,29 @@ def search(
             continuation_token=continuation_token,
         )
 
+    def delete_images(self, image_ids: List[str]) -> dict:
+        """Delete orphan images from the workspace.
+
+        Only deletes images not associated with any project.
+        Images still in projects are skipped.
+
+        Args:
+            image_ids: List of image IDs to delete.
+
+        Returns:
+            Dict with ``deletedSources`` and ``skippedSources`` counts.
+
+        Example:
+            >>> ws = rf.workspace()
+            >>> result = ws.delete_images(["img_id_1", "img_id_2"])
+            >>> print(result["deletedSources"])
+        """
+        return rfapi.workspace_delete_images(
+            api_key=self.__api_key,
+            workspace_url=self.url,
+            image_ids=image_ids,
+        )
+
     def search_all(
         self,
         query: str,