Dropbox

Links

    Dropbox API

    Getting access, Developing, Testing

    Back to Dropbox

    Sharing - Mount Folder

    The current user mounts the designated folder. Mount a shared folder for a user after they have been added as a member. Once mounted, the shared folder will appear in their Dropbox. Apps must have full Dropbox access to use this endpoint.

    Input

    type: object properties: data: type: object description: | shared_folder_id: The ID of the shared folder to mount. properties: shared_folder_id: type: string description: The ID of the shared folder to mount. title: Data

    Output

    type: object description: > The metadata which includes basic information about the shared folder. access_type: The current user's access level for this shared folder. is_inside_team_folder: Whether this folder is inside of a team folder. is_team_folder: Whether this folder is a :link:`team folder https://www.dropbox.com/en/help/986`. name: The name of the this shared folder. policy: Policies governing this shared folder. preview_url: URL for displaying a web preview of the shared folder. shared_folder_id: The ID of the shared folder. time_invited: Timestamp indicating when the current user was invited to this shared folder. owner_display_names: The display names of the users that own the folder. If the folder is part of a team folder, the display names of the team admins are also included. Absent if the owner display names cannot be fetched. owner_team: The team that owns the folder. This field is not present if the folder is not owned by a team. parent_shared_folder_id: The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. path_lower: The lower-cased full path of this shared folder. Absent for unmounted folders. link_metadata: The metadata of the shared content link to this shared folder. Absent if there is no link on the folder. This is for an unreleased feature so it may not be returned yet. permissions: Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. access_inheritance: Whether the folder inherits its members from its parent. properties: owner_team: type: object description: | Information about a team. id: The team's unique ID. name: The name of the team. properties: id: type: string description: The team's unique ID. name: type: string description: The name of the team. parent_shared_folder_id: type: string description: >- The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. link_metadata: type: object description: > Metadata of a shared link for a file or folder. audience_options: The audience options that are available for the content. Some audience options may be unavailable. For example, team_only may be unavailable if the content is not owned by a user on a team. The 'default' audience option is always available if the user can modify link settings. current_audience: The current audience of the link. link_permissions: A list of permissions for actions you can perform on the link. password_protected: Whether the link is protected by a password. url: The URL of the link. access_level: The access level on the link for this file. audience_restricting_shared_folder: The shared folder that prevents the link audience for this link from being more restrictive. expiry: Whether the link has an expiry set on it. A link with an expiry will have its audience changed to members when the expiry is reached. audience_exceptions: The content inside this folder with link audience different than this folder's. This is only returned when an endpoint that returns metadata for a single shared folder is called, e.g. /get_folder_metadata. properties: current_audience: type: object description: | public: Link is accessible by anyone. team: Link is accessible only by team members. members: Link is accessible only by members of the content. other: None properties: .tag: title: Choice of LinkAudience type: string enum: - public - team - members - other url: type: string description: The URL of the link. password_protected: type: boolean description: Whether the link is protected by a password. audience_exceptions: type: object description: > The total count and truncated list of information of content inside this folder that has a different audience than the link on this folder. This is only returned for folders. count: None exceptions: A truncated list of some of the content that is an exception. The length of this list could be smaller than the count since it is only a sample but will not be empty as long as count is not 0. properties: count: type: number exceptions: type: array description: >- A truncated list of some of the content that is an exception. The length of this list could be smaller than the count since it is only a sample but will not be empty as long as count is not 0. items: type: object description: > Information about the content that has a link audience different than that of this folder. name: The name of the content, which is either a file or a folder. properties: name: type: string description: The name of the content, which is either a file or a folder. expiry: type: string description: >- Whether the link has an expiry set on it. A link with an expiry will have its audience changed to members when the expiry is reached. access_level: type: object description: > Defines the access levels for collaborators. owner: The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using :route:`update_folder_policy`. editor: The collaborator can both view and edit the shared folder. viewer: The collaborator can only view the shared folder. viewer_no_comment: The collaborator can only view the shared folder and does not have any access to comments. other: None properties: .tag: title: Choice of AccessLevel type: string enum: - owner - editor - viewer - viewer_no_comment - other audience_restricting_shared_folder: type: object description: > Information about the shared folder that prevents the link audience for this link from being more restrictive. shared_folder_id: The ID of the shared folder. name: The name of the shared folder. audience: The link audience of the shared folder. properties: shared_folder_id: type: string description: The ID of the shared folder. audience: type: object description: | public: Link is accessible by anyone. team: Link is accessible only by team members. members: Link is accessible only by members of the content. other: None properties: .tag: title: Choice of LinkAudience type: string enum: - public - team - members - other name: type: string description: The name of the shared folder. link_permissions: type: array description: A list of permissions for actions you can perform on the link. items: type: object description: | Permissions for actions that can be performed on a link. action: None allow: None reason: None properties: action: type: object description: | Actions that can be performed on a link. change_access_level: Change the access level of the link. change_audience: Change the audience of the link. remove_expiry: Remove the expiry date of the link. remove_password: Remove the password of the link. set_expiry: Create or modify the expiry date of the link. set_password: Create or modify the password of the link. other: None properties: .tag: title: Choice of LinkAction type: string enum: - change_access_level - change_audience - remove_expiry - remove_password - set_expiry - set_password - other reason: type: object description: > Possible reasons the user is denied a permission. user_not_same_team_as_owner: User is not on the same team as the folder owner. user_not_allowed_by_owner: User is prohibited by the owner from taking the action. target_is_indirect_member: Target is indirectly a member of the folder, for example by being part of a group. target_is_owner: Target is the owner of the folder. target_is_self: Target is the user itself. target_not_active: Target is not an active member of the team. folder_is_limited_team_folder: Folder is team folder for a limited team. owner_not_on_team: The content owner needs to be on a Dropbox team to perform this action. permission_denied: The user does not have permission to perform this action on the link. restricted_by_team: The user's team policy prevents performing this action on the link. user_account_type: The user's account type does not support this action. user_not_on_team: The user needs to be on a Dropbox team to perform this action. folder_is_inside_shared_folder: Folder is inside of another shared folder. restricted_by_parent_folder: Policy cannot be changed due to restrictions from parent folder. insufficient_plan: None other: None properties: insufficient_plan: type: object description: > message: A message to tell the user to upgrade in order to support expected action. upsell_url: A URL to send the user to in order to obtain the account type they need, e.g. upgrading. Absent if there is no action the user can take to upgrade. properties: message: type: string description: >- A message to tell the user to upgrade in order to support expected action. upsell_url: type: string description: >- A URL to send the user to in order to obtain the account type they need, e.g. upgrading. Absent if there is no action the user can take to upgrade. .tag: title: Choice of PermissionDeniedReason type: string enum: - user_not_same_team_as_owner - user_not_allowed_by_owner - target_is_indirect_member - target_is_owner - target_is_self - target_not_active - folder_is_limited_team_folder - owner_not_on_team - permission_denied - restricted_by_team - user_account_type - user_not_on_team - folder_is_inside_shared_folder - restricted_by_parent_folder - insufficient_plan - other allow: type: boolean audience_options: type: array description: >- The audience options that are available for the content. Some audience options may be unavailable. For example, team_only may be unavailable if the content is not owned by a user on a team. The 'default' audience option is always available if the user can modify link settings. items: type: object description: | public: Link is accessible by anyone. team: Link is accessible only by team members. members: Link is accessible only by members of the content. other: None properties: .tag: title: Choice of LinkAudience type: string enum: - public - team - members - other time_invited: type: string description: >- Timestamp indicating when the current user was invited to this shared folder. preview_url: type: string description: URL for displaying a web preview of the shared folder. access_type: type: object description: > Defines the access levels for collaborators. owner: The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using :route:`update_folder_policy`. editor: The collaborator can both view and edit the shared folder. viewer: The collaborator can only view the shared folder. viewer_no_comment: The collaborator can only view the shared folder and does not have any access to comments. other: None properties: .tag: title: Choice of AccessLevel type: string enum: - owner - editor - viewer - viewer_no_comment - other name: type: string description: The name of the this shared folder. owner_display_names: type: array description: >- The display names of the users that own the folder. If the folder is part of a team folder, the display names of the team admins are also included. Absent if the owner display names cannot be fetched. items: type: string access_inheritance: type: object description: > Information about the inheritance policy of a shared folder. inherit: The shared folder inherits its members from the parent folder. no_inherit: The shared folder does not inherit its members from the parent folder. other: None properties: .tag: title: Choice of AccessInheritance type: string enum: - inherit - no_inherit - other shared_folder_id: type: string description: The ID of the shared folder. path_lower: type: string description: >- The lower-cased full path of this shared folder. Absent for unmounted folders. policy: type: object description: > A set of policies governing membership and privileges for a shared folder. acl_update_policy: Who can add and remove members from this shared folder. shared_link_policy: Who links can be shared with. member_policy: Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. resolved_member_policy: Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. viewer_info_policy: Who can enable/disable viewer info for this shared folder. properties: viewer_info_policy: type: object description: | enabled: Viewer information is available on this file. disabled: Viewer information is disabled on this file. other: None properties: .tag: title: Choice of ViewerInfoPolicy type: string enum: - enabled - disabled - other resolved_member_policy: type: object description: > Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. team: Only a teammate can become a member. anyone: Anyone can become a member. other: None properties: .tag: title: Choice of MemberPolicy type: string enum: - team - anyone - other acl_update_policy: type: object description: > Who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. owner: Only the owner can update the ACL. editors: Any editor can update the ACL. This may be further restricted to editors on the same team. other: None properties: .tag: title: Choice of AclUpdatePolicy type: string enum: - owner - editors - other shared_link_policy: type: object description: | Who can view shared links in this folder. anyone: Links can be shared with anyone. team: Links can be shared with anyone on the same team as the owner. members: Links can only be shared among members of the shared folder. other: None properties: .tag: title: Choice of SharedLinkPolicy type: string enum: - anyone - team - members - other member_policy: type: object description: > Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. team: Only a teammate can become a member. anyone: Anyone can become a member. other: None properties: .tag: title: Choice of MemberPolicy type: string enum: - team - anyone - other is_inside_team_folder: type: boolean description: Whether this folder is inside of a team folder. is_team_folder: type: boolean description: >- Whether this folder is a :link:`team folder https://www.dropbox.com/en/help/986`. permissions: type: array description: >- Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. items: type: object description: > Whether the user is allowed to take the action on the shared folder. action: The action that the user may wish to take on the folder. allow: True if the user is allowed to take the action. reason: The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. properties: action: type: object description: > Actions that may be taken on shared folders. change_options: Change folder options, such as who can be invited to join the folder. disable_viewer_info: Disable viewer information for this folder. edit_contents: Change or edit contents of the folder. enable_viewer_info: Enable viewer information on the folder. invite_editor: Invite a user or group to join the folder with read and write permission. invite_viewer: Invite a user or group to join the folder with read permission. invite_viewer_no_comment: Invite a user or group to join the folder with read permission but no comment permissions. relinquish_membership: Relinquish one's own membership in the folder. unmount: Unmount the folder. unshare: Stop sharing this folder. leave_a_copy: Keep a copy of the contents upon leaving or being kicked from the folder. share_link: Use create_link instead. create_link: Create a shared link for folder. set_access_inheritance: Set whether the folder inherits permissions from its parent. other: None properties: .tag: title: Choice of FolderAction type: string enum: - change_options - disable_viewer_info - edit_contents - enable_viewer_info - invite_editor - invite_viewer - invite_viewer_no_comment - relinquish_membership - unmount - unshare - leave_a_copy - share_link - create_link - set_access_inheritance - other reason: type: object description: > Possible reasons the user is denied a permission. user_not_same_team_as_owner: User is not on the same team as the folder owner. user_not_allowed_by_owner: User is prohibited by the owner from taking the action. target_is_indirect_member: Target is indirectly a member of the folder, for example by being part of a group. target_is_owner: Target is the owner of the folder. target_is_self: Target is the user itself. target_not_active: Target is not an active member of the team. folder_is_limited_team_folder: Folder is team folder for a limited team. owner_not_on_team: The content owner needs to be on a Dropbox team to perform this action. permission_denied: The user does not have permission to perform this action on the link. restricted_by_team: The user's team policy prevents performing this action on the link. user_account_type: The user's account type does not support this action. user_not_on_team: The user needs to be on a Dropbox team to perform this action. folder_is_inside_shared_folder: Folder is inside of another shared folder. restricted_by_parent_folder: Policy cannot be changed due to restrictions from parent folder. insufficient_plan: None other: None properties: insufficient_plan: type: object description: > message: A message to tell the user to upgrade in order to support expected action. upsell_url: A URL to send the user to in order to obtain the account type they need, e.g. upgrading. Absent if there is no action the user can take to upgrade. properties: message: type: string description: >- A message to tell the user to upgrade in order to support expected action. upsell_url: type: string description: >- A URL to send the user to in order to obtain the account type they need, e.g. upgrading. Absent if there is no action the user can take to upgrade. .tag: title: Choice of PermissionDeniedReason type: string enum: - user_not_same_team_as_owner - user_not_allowed_by_owner - target_is_indirect_member - target_is_owner - target_is_self - target_not_active - folder_is_limited_team_folder - owner_not_on_team - permission_denied - restricted_by_team - user_account_type - user_not_on_team - folder_is_inside_shared_folder - restricted_by_parent_folder - insufficient_plan - other allow: type: boolean description: True if the user is allowed to take the action.