> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/developer/python-sdk/manage-folders.md).

# Manage Folders

Project folders organize the projects in a workspace into nested groups. The Python SDK exposes folder listing and creation directly on `Workspace`; update and delete are available through the low-level `rfapi` adapter.

{% hint style="info" %}
Project folders are an Enterprise feature. The folder endpoints return `403` for non-Enterprise workspaces.
{% endhint %}

## List folders

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
workspace = rf.workspace()

folders = workspace.list_folders()
for folder in folders.get("data", []):
    print(folder["id"], folder["name"])
```

## Create a folder

```python
folder = workspace.create_folder(
    name="Training Data",
    parent_id=None,                              # optional, for nesting
    project_ids=["my-detector", "other-project"], # optional, populate at creation time
)
print(folder["id"])
```

### Parameters

* `name` (str) - folder name shown in the web app.
* `parent_id` (str, optional) - id of an existing folder to nest under. Omit for a top-level folder.
* `project_ids` (list\[str], optional) - project ids to move into the folder at creation time.

## Get a folder

```python
from roboflow.adapters import rfapi

folder = rfapi.get_folder("YOUR_API_KEY", workspace.url, "<folder-id>")
print(folder)
```

## Rename or update a folder

```python
from roboflow.adapters import rfapi

rfapi.update_folder(
    "YOUR_API_KEY",
    workspace.url,
    "<folder-id>",
    name="New Name",
)
```

## Delete a folder

```python
from roboflow.adapters import rfapi

rfapi.delete_folder("YOUR_API_KEY", workspace.url, "<folder-id>")
```

Deleting a folder moves its projects back to the top level - projects themselves are not deleted.

## REST and CLI equivalents

* REST API: see [Manage Project Folders](/developer/rest-api/manage-project-folders.md).
* CLI: see [Manage Folders (CLI)](/developer/command-line-interface/manage-folders.md).