diff --git a/langfuse/api/reference.md b/langfuse/api/reference.md
index 352193f10..e9539c90a 100644
--- a/langfuse/api/reference.md
+++ b/langfuse/api/reference.md
@@ -5123,7 +5123,10 @@ client.prompt_version.update(
 <dl>
 <dd>
 
-**name:** `str` — The name of the prompt
+**name:** `str` 
+
+The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"), 
+the folder path must be URL encoded.
     
 </dd>
 </dl>
@@ -5215,7 +5218,10 @@ client.prompts.get(
 <dl>
 <dd>
 
-**prompt_name:** `str` — The name of the prompt
+**prompt_name:** `str` 
+
+The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"), 
+the folder path must be URL encoded.
     
 </dd>
 </dl>
diff --git a/langfuse/api/resources/prompt_version/client.py b/langfuse/api/resources/prompt_version/client.py
index 89140941d..5387c6e25 100644
--- a/langfuse/api/resources/prompt_version/client.py
+++ b/langfuse/api/resources/prompt_version/client.py
@@ -37,7 +37,8 @@ def update(
         Parameters
         ----------
         name : str
-            The name of the prompt
+            The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"),
+            the folder path must be URL encoded.
 
         version : int
             Version of the prompt to update
@@ -122,7 +123,8 @@ async def update(
         Parameters
         ----------
         name : str
-            The name of the prompt
+            The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"),
+            the folder path must be URL encoded.
 
         version : int
             Version of the prompt to update
diff --git a/langfuse/api/resources/prompts/client.py b/langfuse/api/resources/prompts/client.py
index c38c20156..793cf3f77 100644
--- a/langfuse/api/resources/prompts/client.py
+++ b/langfuse/api/resources/prompts/client.py
@@ -41,7 +41,8 @@ def get(
         Parameters
         ----------
         prompt_name : str
-            The name of the prompt
+            The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"),
+            the folder path must be URL encoded.
 
         version : typing.Optional[int]
             Version of the prompt to be retrieved.
@@ -310,7 +311,8 @@ async def get(
         Parameters
         ----------
         prompt_name : str
-            The name of the prompt
+            The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"),
+            the folder path must be URL encoded.
 
         version : typing.Optional[int]
             Version of the prompt to be retrieved.