A core concept in the Fabric API is a resource. A resource represents entities such as a bookmark, images, folders, and more. The type of resource is described by the kind property.

Folders (kind: ‘folder'), are an essential part of the Fabric filesystem and all resources except top level folders have a parentId property which references its parent resource.

Some non-folder resources, such as emails, notes and other kinds of document also support creation of child resources.

Accessing the top level file structure

Top level folders are called resource roots. Use the /v2/resource-roots endpoint to retrieve the list of all resource roots.

Types of resource roots

In Fabric, there are 3 types of resource roots – system, space, and integration.

System:

System roots are critical system-level folders, and they cannot be created or deleted. Currently the “Inbox” folder is the only system root.

Space:

Space roots can be created or deleted without restriction.

Integration:

Integration roots automatically get created as the containing folder for a connection to a 3rd party data source. These roots cannot be deleted, unless the integration is removed.