Workspaces

A Workspace is a lightweight way to organize related resources inside a single Files.com Site.

Customers commonly group resources by project, department, client, or region. Workspaces provide a built-in structure for that grouping, so the UI can operate within a clear "workspace context" and admins can delegate management for a subset of resources without requiring full site-level isolation.

Every Site has an implicit Default workspace (ID 0). Resources that are not explicitly assigned to a named workspace are considered part of the Default workspace.

The Files.com Ruby SDK supports workspace scoping by using the Files.workspace_id configuration attribute. Scope a single request by passing workspace_id in the request options.

Example Request

require "files.com"

Files.workspace_id = 123

Files::Folder.list_for("", {}, workspace_id: 456)