From 5877225d195174771b54c1cc87a84f7b745d81aa Mon Sep 17 00:00:00 2001
From: Victor Santos <victor@infisical.com>
Date: Fri, 31 Oct 2025 10:37:57 -0300
Subject: [PATCH 1/2] docs: add folder management operations to Python SDK
 documentation

---
 docs/sdks/languages/python.mdx | 65 +++++++++++++++++++++++++++++++++-
 1 file changed, 64 insertions(+), 1 deletion(-)

diff --git a/docs/sdks/languages/python.mdx b/docs/sdks/languages/python.mdx
index 066ecc060..d17043c59 100644
--- a/docs/sdks/languages/python.mdx
+++ b/docs/sdks/languages/python.mdx
@@ -72,6 +72,7 @@ The SDK methods are organized into the following high-level categories:
 1. `auth`: Handles authentication methods.
 2. `secrets`: Manages CRUD operations for secrets.
 3. `kms`: Perform cryptographic operations with Infisical KMS.
+4. `folders`: Manages folder-related operations.
 
 ### `auth`
 
@@ -415,4 +416,66 @@ decrypted_data = client.kms.decrypt_data(
 - `ciphertext` (str): The ciphertext returned from the encrypt operation.
 
 **Returns:**
-- `str`: The base64 encoded plaintext.
\ No newline at end of file
+- `str`: The base64 encoded plaintext.
+
+### `folders`
+
+This sub-class handles operations related to folders:
+
+#### List Folders
+
+```python
+folders = client.folders.list_folders(
+    project_id="<project-id>",
+    environment_slug="dev",
+    path="/",
+    recursive=False, # Optional
+    last_secret_modified=None # Optional
+)
+```
+
+**Parameters:**
+- `project_id` (str): The ID of your project.
+- `environment_slug` (str): The environment in which to list folders.
+- `path` (str): The path to list folders from.
+- `recursive` (bool, optional): Whether to list folders recursively from the specified path and downwards. Defaults to `False`.
+- `last_secret_modified` (datetime, optional): The timestamp used to filter folders with secrets modified after the specified date. Defaults to `None`.
+
+**Returns:**
+- `ListFoldersResponse`: The response containing the list of folders.
+
+#### Create Folder
+
+```python
+new_folder = client.folders.create_folder(
+    name="my-folder",
+    environment_slug="dev",
+    project_id="<project-id>",
+    path="/", # Optional
+    description=None # Optional
+)
+```
+
+**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.
+- `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`.
+
+**Returns:**
+- `CreateFolderResponseItem`: The response containing the created folder.
+
+#### Get Folder by ID
+
+```python
+folder = client.folders.get_folder_by_id(
+    id="<folder-id>"
+)
+```
+
+**Parameters:**
+- `id` (str): The ID of the folder to retrieve.
+
+**Returns:**
+- `SingleFolderResponseItem`: The response containing the folder details.
\ No newline at end of file

From 925ea23bbd2d71812aeba73b5f447042344160ac Mon Sep 17 00:00:00 2001
From: Victor Santos <victor@infisical.com>
Date: Fri, 31 Oct 2025 11:08:48 -0300
Subject: [PATCH 2/2] docs: clarify parameters for folder creation in Python
 SDK documentation

---
 docs/sdks/languages/python.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

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`.