diff --git a/langfuse/api/reference.md b/langfuse/api/reference.md
index 352193f10..7433c043d 100644
--- a/langfuse/api/reference.md
+++ b/langfuse/api/reference.md
@@ -5123,7 +5123,11 @@ 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. For example, use "folder%2Fsubfolder%2Fprompt-name" instead 
+of "folder/subfolder/prompt-name". The forward slash (/) character must be encoded as %2F.
     
 </dd>
 </dl>
@@ -5215,7 +5219,11 @@ 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. For example, use "folder%2Fsubfolder%2Fprompt-name" instead 
+of "folder/subfolder/prompt-name". The forward slash (/) character must be encoded as %2F.
     
 </dd>
 </dl>
diff --git a/langfuse/api/resources/prompt_version/client.py b/langfuse/api/resources/prompt_version/client.py
index 89140941d..0b8f4716b 100644
--- a/langfuse/api/resources/prompt_version/client.py
+++ b/langfuse/api/resources/prompt_version/client.py
@@ -37,7 +37,9 @@ 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. For example, use "folder%2Fsubfolder%2Fprompt-name" instead
+            of "folder/subfolder/prompt-name". The forward slash (/) character must be encoded as %2F.
 
         version : int
             Version of the prompt to update
@@ -122,7 +124,9 @@ 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. For example, use "folder%2Fsubfolder%2Fprompt-name" instead
+            of "folder/subfolder/prompt-name". The forward slash (/) character must be encoded as %2F.
 
         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..d9642e482 100644
--- a/langfuse/api/resources/prompts/client.py
+++ b/langfuse/api/resources/prompts/client.py
@@ -41,7 +41,9 @@ 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. For example, use "folder%2Fsubfolder%2Fprompt-name" instead
+            of "folder/subfolder/prompt-name". The forward slash (/) character must be encoded as %2F.
 
         version : typing.Optional[int]
             Version of the prompt to be retrieved.
@@ -310,7 +312,9 @@ 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. For example, use "folder%2Fsubfolder%2Fprompt-name" instead
+            of "folder/subfolder/prompt-name". The forward slash (/) character must be encoded as %2F.
 
         version : typing.Optional[int]
             Version of the prompt to be retrieved.