diff --git a/docs/sdks/languages/python.mdx b/docs/sdks/languages/python.mdx
index d17043c59..670e0975a 100644
--- a/docs/sdks/languages/python.mdx
+++ b/docs/sdks/languages/python.mdx
@@ -458,8 +458,8 @@ new_folder = client.folders.create_folder(
 
 **Parameters:**
 - `name` (str): The name of the folder to create.
-- `environment_slug` (str): The environment in which to create the folder.
-- `project_id` (str): The ID of your project.
+- `environment_slug` (str): The slug of the environment to create the folder in.
+- `project_id` (str): The ID of your project to create the folder in.
 - `path` (str, optional): The path to create the folder in. Defaults to `/`.
 - `description` (str, optional): An optional description label for the folder. Defaults to `None`.