Skip to content
File Service

Fs Folder

A folder is a container for files and other folders. It is a resource within a space, possessing various attributes (properties) also known as metadata, such as name, access control lists (ACLs), and creation and modification timestamps.

Additional information about the folder can be added as custom metadata during creation. Any valid JSON-formatted key-value pairs are accepted, with a maximum size limit of 64KB.

Folders can have ACLs that define who can access them and what operations they can perform. To learn more about ACLs click here

Root Folder

This folder is automatically created when a space is created, serving as the starting point for any file or folder hierarchy within the space.

Allowed Operations on Root Folder
OperationAllowed Roles
Metadata UpdateContent Manager
ACL UpdateSpace Manager, Content Manager
ExportContent Manager, Content Contributor, Content Viewer
Restricted Operations on Root Folder

The following operations are not allowed on the root folder:

  • Rename
  • Move
  • Delete
  • Copy

Folder versioning

Folder versioning uses a major versioning scheme, where the major version is incremented whenever a mutation operation is performed, such as rename, move, delete, or metadata update.