List Workspaces

Get a Workspace handle for the workspace your API key authenticates against:

import roboflow

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

Each Roboflow API key is scoped to a single workspace. To work against a different workspace, use a different API key (or, for public Universe workspaces, pass the workspace slug):

# Public Universe workspace - only your API key is needed.
public_ws = rf.workspace("roboflow-100")

Workspace properties

The returned Workspace exposes:

  • workspace.url - the workspace's URL slug (e.g. my-workspace).

  • workspace.name - the workspace's display name.

  • workspace.list_projects() - projects in the workspace, as a list of dicts.

  • workspace.projects() - same data as list_projects() but returned as a Project object list (older alias).

  • workspace.list_folders() - see Manage Folders.

  • workspace.list_workflows() - see Manage Workflows.

  • workspace.get_plan() and workspace.get_usage() - see Workspace Plan and Usage.

CLI equivalent

See List Workspaces and Projects (CLI).

Last updated

Was this helpful?