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 Java SDK supports workspace scoping by using the FilesClient.workspaceId configuration attribute. Scope a single request by passing workspace_id in the request options.

Example Request

import com.files.FilesClient;
import com.files.models.Folder;
import java.util.HashMap;

FilesClient.workspaceId = 123L;

HashMap<String, Object> options = new HashMap<>();
options.put("workspace_id", 456L);

Folder.listFor("/", null, options);