FileLinks
Lists all shared links associated with files in a user's Dropbox, enabling insight into external sharing activity.
Table Specific Information
The following scopes are required to access this view: sharing.readSelect
The cmdlet uses the Dropbox API to process search criteria that refer to the FilePath or Revision columns. The cmdlet processes other filters client-side within the cmdlet. For example, the following queries are processed server side.
SELECT * FROM FileLinks WHERE FilePath = '/Test Folder' SELECT * FROM FileLinks WHERE Revision = '4e52306b0'
Columns
| Name | Type | ReadOnly | Description |
| Id [KEY] | String | True |
A unique identifier for the shared file link. |
| Url [KEY] | String | False |
The URL of the shared Dropbox link for the file. |
| Name | String | True |
The name of the file associated with the shared link, including its extension. |
| CanRevoke | Boolean | True |
Indicates whether the user has permission to revoke (disable) the shared link. |
| ResolvedVisibilityPermission | String | True |
The effective visibility of the link after applying team and shared folder policies. This may differ from the originally requested visibility. |
| RequestedVisibilityPermission | String | False |
The visibility setting requested by the link creator. This may be overridden by team or folder policies. Basic users can only set RequestedVisibility.public as the requested visibility. The allowed values are public, team_only, password. |
| RevokeFailureReason | String | True |
The reason why the shared link cannot be revoked. Present only when the CanRevoke field is False. |
| ClientModified | Datetime | True |
The timestamp when the file was last modified by the desktop client before upload. |
| ServerModified | Datetime | True |
The timestamp of the most recent modification made to the file on Dropbox servers. |
| Revision | String | True |
A unique Id representing the current revision of the file. |
| Size | Long | True |
The size of the file in bytes. |
| PathLower | String | True |
The full Dropbox path to the file in lowercase, used for consistency in path matching. |
| FilePath | String | False |
The original cased path of the file, used for display purposes. |
| TeamId | String | True |
The unique identifier of the Dropbox team the user belongs to. |
| TeamName | String | True |
The registered name of the Dropbox team. |
| TeamDisplayName | String | True |
The display name of the user who shared the file. |
| TeamMemberId | String | True |
The team member Id of the user who created the link; present only if that user belongs to the same team as the current user. |
| ContentOwnerId | String | True |
The unique Id of the team that owns the content being shared. |
| ContentOwnerName | String | True |
The name of the team that owns the content. |
| RemoveExpiration | Boolean | False |
When set to True, removes any expiration date set for the shared link. The default value is False. |
| RequestedAccess | String | False |
The access level (such as viewer or editor) requested for users accessing the shared link. Modifying access on an existing link is not supported. This field is optional. The allowed values are viewer, editor, max. |
| Expires | Datetime | False |
The expiration date and time of the shared link, if one is set. By default, links do not expire. This field is optional. Basic users can only use RequestedVisibility.public. |
| LinkPassword | String | False |
The password required to access the link if RequestedVisibility is set to password. This field is optional. |
| Audience | String | False |
The group of users (such as team members or anyone with the link) who can access the file based on the link's access level. The allowed values are public, team, no_one, password. |