trash: use "project" instead of "dataset" for the item-type vocabulary

Aligns the SDK with the rest of the public API. Diego flagged on the
docs PR that DELETE responses use `type: "project"` but the trash
list/restore payloads were using `type: "dataset"` — same item, two
names. Fixing on `"project"` to match the rest of the public surface
(`:project` URL params, DELETE responses, the `project:*` scope
namespace).

Backend ships the same change on the `soft-delete` branch; the docs
PR covers the user-visible REST API and SDK pages.

- `Project.restore()`: looks up `trash["sections"]["projects"]` and
  passes `"project"` to `rfapi.restore_trash_item`. Docstring updated
  to show `type: "project"` in the example response.
- `Workspace.restore_from_trash()`: docstring lists the valid item
  types as `"project"`, `"version"`, `"workflow"` (was
  `"dataset"`/.../...).
- `roboflow project restore` CLI: same lookup + restore call.
- `rfapi.restore_trash_item` docstring: matching update.
- Tests under `tests/cli/test_project_handler.py` and
  `tests/cli/test_trash_handler.py` now exercise the project
  vocabulary.

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

Author: yeldarby

roboflow/adapters/rfapi.py

@@ -931,8 +931,8 @@ def list_trash(api_key, workspace_url):
 def restore_trash_item(api_key, workspace_url, item_type, item_id, parent_id=None):
     """POST /{workspace}/trash/restore — restore an item from Trash.
 
-    `item_type` must be one of "dataset", "version", "workflow".
-    `parent_id` is required when restoring a version (the dataset id).
+    `item_type` must be one of "project", "version", "workflow".
+    `parent_id` is required when restoring a version (the parent project id).
     """
     url = f"{API_URL}/{workspace_url}/trash/restore?api_key={api_key}"
     payload = {"type": item_type, "id": item_id}

roboflow/cli/handlers/project.py

@@ -314,8 +314,8 @@ def _restore_project(args):  # noqa: ANN001
         )
         return
 
-    datasets = trash.get("sections", {}).get("datasets", [])
-    match = next((d for d in datasets if d.get("url") == project_slug), None)
+    projects = trash.get("sections", {}).get("projects", [])
+    match = next((p for p in projects if p.get("url") == project_slug), None)
     if not match:
         output_error(
             args,
@@ -326,7 +326,7 @@ def _restore_project(args):  # noqa: ANN001
         return
 
     try:
-        data = rfapi.restore_trash_item(api_key, workspace_url, "dataset", match["id"])
+        data = rfapi.restore_trash_item(api_key, workspace_url, "project", match["id"])
     except rfapi.RoboflowError as exc:
         output_error(
             args,

roboflow/core/project.py

@@ -1069,7 +1069,7 @@ def restore(self):
         RuntimeError if the project isn't currently in Trash.
 
         Returns:
-            dict: Server response with `{restored: True, type: "dataset", ...}`.
+            dict: Server response with `{restored: True, type: "project", ...}`.
 
         Example:
             >>> import roboflow
@@ -1079,8 +1079,8 @@ def restore(self):
             >>> project.restore()
         """
         trash = rfapi.list_trash(self.__api_key, self.__workspace)
-        datasets = trash.get("sections", {}).get("datasets", [])
-        match = next((d for d in datasets if d.get("url") == self.__project_name), None)
+        projects = trash.get("sections", {}).get("projects", [])
+        match = next((p for p in projects if p.get("url") == self.__project_name), None)
         if not match:
             raise RuntimeError(f"Project '{self.__project_name}' is not in Trash — nothing to restore.")
-        return rfapi.restore_trash_item(self.__api_key, self.__workspace, "dataset", match["id"])
+        return rfapi.restore_trash_item(self.__api_key, self.__workspace, "project", match["id"])

roboflow/core/workspace.py

@@ -1339,7 +1339,7 @@ def trash(self) -> dict:
 
         Returns a dict with:
           - `items`: flat list of everything in Trash
-          - `sections`: grouped by `datasets`, `versions`, `workflows`
+          - `sections`: grouped by `projects`, `versions`, `workflows`
         Each item includes `id`, `type`, `name`, `deletedAt`,
         `scheduledCleanupAt`, and — for versions — `parentId` / `parentUrl`.
 
@@ -1358,9 +1358,9 @@ def restore_from_trash(self, item_type: str, item_id: str, parent_id: Optional[s
         Restore an item from Trash.
 
         Args:
-            item_type: one of "dataset", "version", "workflow"
+            item_type: one of "project", "version", "workflow"
             item_id: the item's Firestore id (found via `trash()`)
-            parent_id: required when restoring a version — the parent dataset id
+            parent_id: required when restoring a version — the parent project id
 
         Returns:
             dict: Server response with `{restored: True, type, id}`.

tests/cli/test_project_handler.py

@@ -94,16 +94,16 @@ def test_restore_found(self) -> None:
 
         from roboflow.cli.handlers.project import _restore_project
 
-        trash = {"sections": {"datasets": [{"id": "abc123", "url": "my-proj", "name": "My Project"}]}}
+        trash = {"sections": {"projects": [{"id": "abc123", "url": "my-proj", "name": "My Project"}]}}
         with (
             patch("roboflow.adapters.rfapi.list_trash", return_value=trash),
             patch(
                 "roboflow.adapters.rfapi.restore_trash_item",
-                return_value={"restored": True, "type": "dataset", "id": "abc123"},
+                return_value={"restored": True, "type": "project", "id": "abc123"},
             ) as mock_restore,
         ):
             _restore_project(self._args())
-            mock_restore.assert_called_once_with("fake-key", "my-ws", "dataset", "abc123")
+            mock_restore.assert_called_once_with("fake-key", "my-ws", "project", "abc123")
 
     def test_restore_not_in_trash(self) -> None:
         from unittest.mock import patch
@@ -115,7 +115,7 @@ def test_restore_not_in_trash(self) -> None:
         with (
             patch(
                 "roboflow.adapters.rfapi.list_trash",
-                return_value={"sections": {"datasets": []}},
+                return_value={"sections": {"projects": []}},
             ),
             patch("roboflow.adapters.rfapi.restore_trash_item") as mock_restore,
             patch("sys.exit"),

tests/cli/test_trash_handler.py

@@ -59,7 +59,7 @@ def test_list_text_output(self) -> None:
         trash_response = {
             "items": [
                 {
-                    "type": "dataset",
+                    "type": "project",
                     "id": "d1",
                     "name": "My Project",
                     "deletedAt": "2026-04-01",