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.

Using Workspaces with the REST API

To use Workspaces with the REST API, send the following request header:

X-Files-Workspace-Id: <workspace_id>

This changes path mapping and "what you're looking at."

When the X-Files-Workspace-Id header is provided:

  • List, show, update, and delete operations are constrained to that workspace for workspace-scoped models.
  • Create operations default workspace_id to the scoped workspace when not explicitly provided.
  • Attempts to provide a mismatching workspace_id are rejected with not-authorized/insufficient-permission-for-params.

This header only works for sitewide keys, or keys related to users with permissions to more than one workspace.