From 122511529cd7e3f40c6de6ea5a41e6d2234038a9 Mon Sep 17 00:00:00 2001
From: Rodrigo Barbosa <rodrigo@roboflow.com>
Date: Fri, 30 Jan 2026 17:10:43 +0000
Subject: [PATCH] imrpoving docs

---
 roboflow/core/project.py | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/roboflow/core/project.py b/roboflow/core/project.py
index 088c804f..ab96fb27 100644
--- a/roboflow/core/project.py
+++ b/roboflow/core/project.py
@@ -672,7 +672,9 @@ def search(
             batch_id (str): batch id that an image must be in
             annotation_job (bool): whether the image must be in an annotation job
             annotation_job_id (str): annotation job id that an image must be in
-            fields (list): fields to return in results (default: ["id", "created", "name", "labels"])
+            fields (list): fields to return in results (default: ["id", "created", "name", "labels"]).
+                Available fields: id, name, created, annotations, labels, split, tags, owner,
+                embedding, user_metadata.
 
         Returns:
             A list of images that match the search criteria.
@@ -684,7 +686,14 @@ def search(
 
             >>> project = rf.workspace().project("PROJECT_ID")
 
-            >>> results = project.search(query="cat", limit=10)
+            >>> # Basic search
+            >>> results = project.search(prompt="cat", limit=10)
+
+            >>> # Search with tags and user_metadata
+            >>> results = project.search(
+            ...     limit=10,
+            ...     fields=["id", "name", "tags", "user_metadata"]
+            ... )
         """  # noqa: E501 // docs
         if fields is None:
             fields = ["id", "created", "name", "labels"]
@@ -764,10 +773,12 @@ def search_all(
             batch_id (str): batch id that an image must be in
             annotation_job (bool): whether the image must be in an annotation job
             annotation_job_id (str): annotation job id that an image must be in
-            fields (list): fields to return in results (default: ["id", "created", "name", "labels"])
+            fields (list): fields to return in results (default: ["id", "created"]).
+                Available fields: id, name, created, annotations, labels, split, tags, owner,
+                embedding, user_metadata.
 
         Returns:
-            A list of images that match the search criteria.
+            A generator yielding images that match the search criteria.
 
         Example:
             >>> import roboflow
@@ -776,10 +787,9 @@ def search_all(
 
             >>> project = rf.workspace().project("PROJECT_ID")
 
-            >>> results = project.search_all(query="cat", limit=10)
+            >>> results = project.search_all(prompt="cat", limit=10)
 
             >>> for result in results:
-
             >>>     print(result)
         """  # noqa: E501 // docs
         if fields is None: