Manage Folders

Create, list, and update workspace project folders from the Python SDK.

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.

Project folders are an Enterprise feature. The folder endpoints return 403 for non-Enterprise workspaces.

List folders

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

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

from roboflow.adapters import rfapi

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

Rename or update a folder

from roboflow.adapters import rfapi

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

Delete a folder

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.

• CLI: see Manage Folders (CLI).