Users

The Users functions allows you to manage user accounts within your Files.com site.

User Permissions

Because the permission on the ExaVault platform differed from what is available on the Files.com platform, interacting with user permissions through the ExaVault Legacy APIs requires some translation.

Some of the ExaVault permissions, such as notification, viewFormData, deleteFormData, or undelete are meaningless in the Files.com platform. Other ExaVault permissions, such as modify and delete, are contained within other Files.com permissions.

In addition, some combinations of permissions are no longer supported. For example, it is not possible to create a user who has upload but not list permissions, so assigning a user upload permissions via the legacy ExaVault API will also grant list permissions.

How ExaVault Permissions Map to Files.com Permissions

When you provide permissions for endpoints that create or modify users, the resulting user in your Files.com site may have permissions you did not expect. This is mostly due to the difference in how the platforms handle the ability for users to delete or overwrite files.

When you create or update a user with a combination of legacy permissions, the result will be the union of the resulting permissions in Files.com.

Granted Legacy PermissionResulting User Permissions in Files.com
listlist
downloadread + list
uploadfull + write + read + list
modifyfull + write + read + list
deletefull + write + read + list
sharelist + read + share
changePasswordNone granted. This is a user setting for whether the user can change their password.
notification, viewFormData, deleteFormDataNone granted. This is not a separate permission in Files.com.

How Files.com Permissions Map to ExaVault Permissions

As described above, the permission information returned by the legacy ExaVault API requires some interpretation.

We do not recommend the use of the legacy ExaVault APIs to audit your user permissions within the Files.com platform. Instead, you should use one of the Files.com SDKs, which will return information consistent with the actual user permissions.

Files.com Permissions Assigned to UserReturned ExaVault User Permission
admin (includes full, write, read, list, share, history)download, upload, modify, delete, list, share, notification, viewFormData, deleteFormData
full (includes write, read, list)download, upload, modify, delete, list, notification
read/write (includes list)download, upload
read (includes list)download, notification
write (includes list)upload
share (includes read, list)download, list, share
history (includes list)none

ExaVault Home Directories versus Files.com Path Permissions

The ExaVault platform supported assigning only a single home directory for a user, and all permissions were granted recursively within that path. This means that the legacy ExaVault API can only support a single path for a user's permissions.

If you have granted your users permission to multiple paths within Files.com, the legacy ExaVault API may return unexpected results.

Get Instant Access to Files.com

The button below will take you to our Free Trial signup page. Click on the white "Start My Free Trial" button, then fill out the short form on the next page. Your account will be activated instantly. You can dive in and start yourself or let us help. The choice is yours.

Start My Free Trial

©2024 Files.com. All right reserved

FILES.COM

  • Start My Free Trial
  • Pricing
  • Docs
  • API and SDKs
  • Contact

CONTACT & SUPPORT

support@files.com

(800) 286-8372

Monday–Friday

9am–8pm Eastern