> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.dropboxapi.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.dropboxapi.com/_mcp/server.

# Mount Folder

POST https://api.dropboxapi.com/2/sharing/mount_folder
Content-Type: application/json

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.

**Required scope:** `sharing.write`

**Endpoint format:** [RPC](https://docs.dropboxapi.com/dropbox-api/docs/technical-reference/request-response-formats#rpc-endpoints)

**Authentication:** [User](https://docs.dropboxapi.com/dropbox-api/docs/auth-types#user-authentication)

This endpoint does not support apps with the app folder permission.

Reference: https://docs.dropboxapi.com/dropbox-api/api-reference/user-endpoints/sharing/mount-folder

## Authentication

- `Authorization` header (bearer token, required) — OAuth 2.0 token issued to a specific user. Use `Authorization: Bearer <token>`. Public clients should use the authorization code flow with PKCE (S256). For background or offline access, send `token_access_type=offline` during authorization and use the returned refresh token to obtain new access tokens. You can generate a short-lived access token from the App Console; see [Testing with a generated token](https://docs.dropboxapi.com/dropbox-api/docs/oauth#testing-with-a-generated-token).

## Request

### Headers

- `Dropbox-API-Select-User` (string, optional) — Acts on behalf of a team member for supported user-auth operations. Pass a team member ID such as `dbmid:...`. When used with a team token, that token must also include the `team_data.member` scope.
- `Dropbox-API-Path-Root` (string, optional) — Scopes path-based operations to a namespace (root). The value is a JSON serialization of the `common.PathRoot` union: `{".tag": "home"}`, `{".tag": "root", "root": "<namespace_id>"}`, or `{".tag": "namespace_id", "namespace_id": "<namespace_id>"}`. On failure the request returns 422 with a `common.PathRootError`.

### Body (application/json)

This endpoint expects an object.

- `shared_folder_id` (any, required) — The ID of the shared folder to mount.

## Response

### 200

Successful response

- `access_type` (object or object or object or object or object or object or object, required) — The current user's access level for this shared folder.
  - sharing_apiv2.AccessLevel.owner
    - `.tag` (enum, required)
      - Allowed values: `owner`
  - sharing_apiv2.AccessLevel.editor
    - `.tag` (enum, required)
      - Allowed values: `editor`
  - sharing_apiv2.AccessLevel.viewer
    - `.tag` (enum, required)
      - Allowed values: `viewer`
  - sharing_apiv2.AccessLevel.viewer_no_comment
    - `.tag` (enum, required)
      - Allowed values: `viewer_no_comment`
  - sharing_apiv2.AccessLevel.traverse
    - `.tag` (enum, required)
      - Allowed values: `traverse`
  - sharing_apiv2.AccessLevel.no_access
    - `.tag` (enum, required)
      - Allowed values: `no_access`
  - Other
    - `.tag` (string, optional)
- `is_inside_team_folder` (boolean, required) — Whether this folder is inside of a team folder.
- `is_team_folder` (boolean, required) — Whether this folder is a [team folder](https://www.dropbox.com/en/help/986).
- `name` (string, required) — The name of the this shared folder.
- `policy` (object, required) — Policies governing this shared folder.
  - `acl_update_policy` (object or object or object, required) — Who can add and remove members from this shared folder.
    - sharing_apiv2.AclUpdatePolicy.owner
      - `.tag` (enum, required)
        - Allowed values: `owner`
    - sharing_apiv2.AclUpdatePolicy.editors
      - `.tag` (enum, required)
        - Allowed values: `editors`
    - Other
      - `.tag` (string, optional)
  - `shared_link_policy` (object or object or object or object, required) — Who links can be shared with.
    - sharing_apiv2.SharedLinkPolicy.anyone
      - `.tag` (enum, required)
        - Allowed values: `anyone`
    - sharing_apiv2.SharedLinkPolicy.team
      - `.tag` (enum, required)
        - Allowed values: `team`
    - sharing_apiv2.SharedLinkPolicy.members
      - `.tag` (enum, required)
        - Allowed values: `members`
    - Other
      - `.tag` (string, optional)
  - `member_policy` (object or object or object or object, optional, nullable) — 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.
    - sharing_apiv2.MemberPolicy.team
      - `.tag` (enum, required)
        - Allowed values: `team`
    - sharing_apiv2.MemberPolicy.anyone
      - `.tag` (enum, required)
        - Allowed values: `anyone`
    - sharing_apiv2.MemberPolicy.team_and_approved
      - `.tag` (enum, required)
        - Allowed values: `team_and_approved`
    - Other
      - `.tag` (string, optional)
  - `resolved_member_policy` (object or object or object or object, optional, nullable) — 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.
    - sharing_apiv2.MemberPolicy.team
      - `.tag` (enum, required)
        - Allowed values: `team`
    - sharing_apiv2.MemberPolicy.anyone
      - `.tag` (enum, required)
        - Allowed values: `anyone`
    - sharing_apiv2.MemberPolicy.team_and_approved
      - `.tag` (enum, required)
        - Allowed values: `team_and_approved`
    - Other
      - `.tag` (string, optional)
  - `viewer_info_policy` (object or object or object, optional, nullable) — Who can enable/disable viewer info for this shared folder.
    - sharing_apiv2.ViewerInfoPolicy.enabled
      - `.tag` (enum, required)
        - Allowed values: `enabled`
    - sharing_apiv2.ViewerInfoPolicy.disabled
      - `.tag` (enum, required)
        - Allowed values: `disabled`
    - Other
      - `.tag` (string, optional)
- `preview_url` (string, required) — URL for displaying a web preview of the shared folder.
- `shared_folder_id` (any, required) — The ID of the shared folder.
- `time_invited` (datetime, required) — Timestamp indicating when the current user was invited to this shared folder.
- `access_inheritance` (object or object or object, optional, nullable) — Whether the folder inherits its members from its parent.
  - sharing_apiv2.AccessInheritance.inherit
    - `.tag` (enum, required)
      - Allowed values: `inherit`
  - sharing_apiv2.AccessInheritance.no_inherit
    - `.tag` (enum, required)
      - Allowed values: `no_inherit`
  - Other
    - `.tag` (string, optional)
- `folder_id` (string, optional, nullable) — The ID of the content.
- `link_metadata` (object, optional, nullable) — 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.
  - `audience_options` (list of object or object or object or object or object or object, required) — 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.
    - sharing_apiv2.LinkAudience.public
      - `.tag` (enum, required)
        - Allowed values: `public`
    - sharing_apiv2.LinkAudience.team
      - `.tag` (enum, required)
        - Allowed values: `team`
    - sharing_apiv2.LinkAudience.no_one
      - `.tag` (enum, required)
        - Allowed values: `no_one`
    - sharing_apiv2.LinkAudience.password
      - `.tag` (enum, required)
        - Allowed values: `password`
    - sharing_apiv2.LinkAudience.members
      - `.tag` (enum, required)
        - Allowed values: `members`
    - Other
      - `.tag` (string, optional)
  - `current_audience` (object or object or object or object or object or object, required) — The current audience of the link.
    - sharing_apiv2.LinkAudience.public
      - `.tag` (enum, required)
        - Allowed values: `public`
    - sharing_apiv2.LinkAudience.team
      - `.tag` (enum, required)
        - Allowed values: `team`
    - sharing_apiv2.LinkAudience.no_one
      - `.tag` (enum, required)
        - Allowed values: `no_one`
    - sharing_apiv2.LinkAudience.password
      - `.tag` (enum, required)
        - Allowed values: `password`
    - sharing_apiv2.LinkAudience.members
      - `.tag` (enum, required)
        - Allowed values: `members`
    - Other
      - `.tag` (string, optional)
  - `link_permissions` (list of object, required) — A list of permissions for actions you can perform on the link.
    - `action` (object or object or object or object or object or object or object, required) — Actions that can be performed on a link.
      - sharing_apiv2.LinkAction.change_access_level
        - `.tag` (enum, required)
          - Allowed values: `change_access_level`
      - sharing_apiv2.LinkAction.change_audience
        - `.tag` (enum, required)
          - Allowed values: `change_audience`
      - sharing_apiv2.LinkAction.remove_expiry
        - `.tag` (enum, required)
          - Allowed values: `remove_expiry`
      - sharing_apiv2.LinkAction.remove_password
        - `.tag` (enum, required)
          - Allowed values: `remove_password`
      - sharing_apiv2.LinkAction.set_expiry
        - `.tag` (enum, required)
          - Allowed values: `set_expiry`
      - sharing_apiv2.LinkAction.set_password
        - `.tag` (enum, required)
          - Allowed values: `set_password`
      - Other
        - `.tag` (string, optional)
    - `allow` (boolean, required)
    - `reason` (object or object or object or object or object or object or object or object or object or object or object or object or object or object or object or object, optional, nullable) — Possible reasons the user is denied a permission.
      - sharing_apiv2.PermissionDeniedReason.user_not_same_team_as_owner
        - `.tag` (enum, required)
          - Allowed values: `user_not_same_team_as_owner`
      - sharing_apiv2.PermissionDeniedReason.user_not_allowed_by_owner
        - `.tag` (enum, required)
          - Allowed values: `user_not_allowed_by_owner`
      - sharing_apiv2.PermissionDeniedReason.target_is_indirect_member
        - `.tag` (enum, required)
          - Allowed values: `target_is_indirect_member`
      - sharing_apiv2.PermissionDeniedReason.target_is_owner
        - `.tag` (enum, required)
          - Allowed values: `target_is_owner`
      - sharing_apiv2.PermissionDeniedReason.target_is_self
        - `.tag` (enum, required)
          - Allowed values: `target_is_self`
      - sharing_apiv2.PermissionDeniedReason.target_not_active
        - `.tag` (enum, required)
          - Allowed values: `target_not_active`
      - sharing_apiv2.PermissionDeniedReason.folder_is_limited_team_folder
        - `.tag` (enum, required)
          - Allowed values: `folder_is_limited_team_folder`
      - sharing_apiv2.PermissionDeniedReason.owner_not_on_team
        - `.tag` (enum, required)
          - Allowed values: `owner_not_on_team`
      - sharing_apiv2.PermissionDeniedReason.permission_denied
        - `.tag` (enum, required)
          - Allowed values: `permission_denied`
      - sharing_apiv2.PermissionDeniedReason.restricted_by_team
        - `.tag` (enum, required)
          - Allowed values: `restricted_by_team`
      - sharing_apiv2.PermissionDeniedReason.user_account_type
        - `.tag` (enum, required)
          - Allowed values: `user_account_type`
      - sharing_apiv2.PermissionDeniedReason.user_not_on_team
        - `.tag` (enum, required)
          - Allowed values: `user_not_on_team`
      - sharing_apiv2.PermissionDeniedReason.folder_is_inside_shared_folder
        - `.tag` (enum, required)
          - Allowed values: `folder_is_inside_shared_folder`
      - sharing_apiv2.PermissionDeniedReason.restricted_by_parent_folder
        - `.tag` (enum, required)
          - Allowed values: `restricted_by_parent_folder`
      - sharing_apiv2.PermissionDeniedReason.insufficient_plan
        - `.tag` (enum, required)
          - Allowed values: `insufficient_plan`
        - `message` (string, required) — A message to tell the user to upgrade in order to support expected action.
        - `upsell_url` (string, optional, nullable) — 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.
      - Other
        - `.tag` (string, optional)
  - `password_protected` (boolean, required) — Whether the link is protected by a password.
  - `url` (string, required) — The URL of the link.
  - `access_level` (object or object or object or object or object or object or object, optional, nullable) — The access level on the link for this file.
    - sharing_apiv2.AccessLevel.owner
      - `.tag` (enum, required)
        - Allowed values: `owner`
    - sharing_apiv2.AccessLevel.editor
      - `.tag` (enum, required)
        - Allowed values: `editor`
    - sharing_apiv2.AccessLevel.viewer
      - `.tag` (enum, required)
        - Allowed values: `viewer`
    - sharing_apiv2.AccessLevel.viewer_no_comment
      - `.tag` (enum, required)
        - Allowed values: `viewer_no_comment`
    - sharing_apiv2.AccessLevel.traverse
      - `.tag` (enum, required)
        - Allowed values: `traverse`
    - sharing_apiv2.AccessLevel.no_access
      - `.tag` (enum, required)
        - Allowed values: `no_access`
    - Other
      - `.tag` (string, optional)
  - `audience_exceptions` (object, optional, nullable) — 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.
    - `count` (uint, required)
    - `exceptions` (list of object, required) — 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.
      - `name` (string, required) — The name of the content, which is either a file or a folder.
  - `audience_restricting_shared_folder` (object, optional, nullable) — The shared folder that prevents the link audience for this link from being more restrictive.
    - `audience` (object or object or object or object or object or object, required) — The link audience of the shared folder.
      - sharing_apiv2.LinkAudience.public
        - `.tag` (enum, required)
          - Allowed values: `public`
      - sharing_apiv2.LinkAudience.team
        - `.tag` (enum, required)
          - Allowed values: `team`
      - sharing_apiv2.LinkAudience.no_one
        - `.tag` (enum, required)
          - Allowed values: `no_one`
      - sharing_apiv2.LinkAudience.password
        - `.tag` (enum, required)
          - Allowed values: `password`
      - sharing_apiv2.LinkAudience.members
        - `.tag` (enum, required)
          - Allowed values: `members`
      - Other
        - `.tag` (string, optional)
    - `name` (string, required) — The name of the shared folder.
    - `shared_folder_id` (any, required) — The ID of the shared folder.
  - `expiry` (datetime, optional, nullable) — 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.
- `owner_display_names` (list of string, optional, nullable) — 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` (object, optional, nullable) — The team that owns the folder. This field is not present if the folder is not owned by a team.
  - `id` (string, required) — The team's unique ID.
  - `name` (string, required) — The name of the team.
- `parent_folder_name` (string, optional, nullable) — Display name for the parent folder.
- `parent_shared_folder_id` (any, optional, nullable) — The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder.
- `path_display` (string, optional, nullable) — The full path of this shared folder. Absent for unmounted folders.
- `path_lower` (string, optional, nullable) — The lower-cased full path of this shared folder. Absent for unmounted folders.
- `permissions` (list of object, optional, nullable) — Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request.
  - `action` (object or object or object or object or object or object or object or object or object or object or object or object or object or object or object or object or object, required) — The action that the user may wish to take on the folder.
    - sharing_apiv2.FolderAction.change_options
      - `.tag` (enum, required)
        - Allowed values: `change_options`
    - sharing_apiv2.FolderAction.disable_viewer_info
      - `.tag` (enum, required)
        - Allowed values: `disable_viewer_info`
    - sharing_apiv2.FolderAction.edit_contents
      - `.tag` (enum, required)
        - Allowed values: `edit_contents`
    - sharing_apiv2.FolderAction.enable_viewer_info
      - `.tag` (enum, required)
        - Allowed values: `enable_viewer_info`
    - sharing_apiv2.FolderAction.invite_editor
      - `.tag` (enum, required)
        - Allowed values: `invite_editor`
    - sharing_apiv2.FolderAction.invite_viewer
      - `.tag` (enum, required)
        - Allowed values: `invite_viewer`
    - sharing_apiv2.FolderAction.invite_viewer_no_comment
      - `.tag` (enum, required)
        - Allowed values: `invite_viewer_no_comment`
    - sharing_apiv2.FolderAction.relinquish_membership
      - `.tag` (enum, required)
        - Allowed values: `relinquish_membership`
    - sharing_apiv2.FolderAction.unmount
      - `.tag` (enum, required)
        - Allowed values: `unmount`
    - sharing_apiv2.FolderAction.unshare
      - `.tag` (enum, required)
        - Allowed values: `unshare`
    - sharing_apiv2.FolderAction.leave_a_copy
      - `.tag` (enum, required)
        - Allowed values: `leave_a_copy`
    - sharing_apiv2.FolderAction.share_link
      - `.tag` (enum, required)
        - Allowed values: `share_link`
    - sharing_apiv2.FolderAction.create_link
      - `.tag` (enum, required)
        - Allowed values: `create_link`
    - sharing_apiv2.FolderAction.create_view_link
      - `.tag` (enum, required)
        - Allowed values: `create_view_link`
    - sharing_apiv2.FolderAction.create_edit_link
      - `.tag` (enum, required)
        - Allowed values: `create_edit_link`
    - sharing_apiv2.FolderAction.set_access_inheritance
      - `.tag` (enum, required)
        - Allowed values: `set_access_inheritance`
    - Other
      - `.tag` (string, optional)
  - `allow` (boolean, required) — True if the user is allowed to take the action.
  - `reason` (object or object or object or object or object or object or object or object or object or object or object or object or object or object or object or object, optional, nullable) — The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available.
    - sharing_apiv2.PermissionDeniedReason.user_not_same_team_as_owner
      - `.tag` (enum, required)
        - Allowed values: `user_not_same_team_as_owner`
    - sharing_apiv2.PermissionDeniedReason.user_not_allowed_by_owner
      - `.tag` (enum, required)
        - Allowed values: `user_not_allowed_by_owner`
    - sharing_apiv2.PermissionDeniedReason.target_is_indirect_member
      - `.tag` (enum, required)
        - Allowed values: `target_is_indirect_member`
    - sharing_apiv2.PermissionDeniedReason.target_is_owner
      - `.tag` (enum, required)
        - Allowed values: `target_is_owner`
    - sharing_apiv2.PermissionDeniedReason.target_is_self
      - `.tag` (enum, required)
        - Allowed values: `target_is_self`
    - sharing_apiv2.PermissionDeniedReason.target_not_active
      - `.tag` (enum, required)
        - Allowed values: `target_not_active`
    - sharing_apiv2.PermissionDeniedReason.folder_is_limited_team_folder
      - `.tag` (enum, required)
        - Allowed values: `folder_is_limited_team_folder`
    - sharing_apiv2.PermissionDeniedReason.owner_not_on_team
      - `.tag` (enum, required)
        - Allowed values: `owner_not_on_team`
    - sharing_apiv2.PermissionDeniedReason.permission_denied
      - `.tag` (enum, required)
        - Allowed values: `permission_denied`
    - sharing_apiv2.PermissionDeniedReason.restricted_by_team
      - `.tag` (enum, required)
        - Allowed values: `restricted_by_team`
    - sharing_apiv2.PermissionDeniedReason.user_account_type
      - `.tag` (enum, required)
        - Allowed values: `user_account_type`
    - sharing_apiv2.PermissionDeniedReason.user_not_on_team
      - `.tag` (enum, required)
        - Allowed values: `user_not_on_team`
    - sharing_apiv2.PermissionDeniedReason.folder_is_inside_shared_folder
      - `.tag` (enum, required)
        - Allowed values: `folder_is_inside_shared_folder`
    - sharing_apiv2.PermissionDeniedReason.restricted_by_parent_folder
      - `.tag` (enum, required)
        - Allowed values: `restricted_by_parent_folder`
    - sharing_apiv2.PermissionDeniedReason.insufficient_plan
      - `.tag` (enum, required)
        - Allowed values: `insufficient_plan`
      - `message` (string, required) — A message to tell the user to upgrade in order to support expected action.
      - `upsell_url` (string, optional, nullable) — 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.
    - Other
      - `.tag` (string, optional)

## Errors

### 401 Unauthorized Error

Bad or expired token

- `error` (object or object or object or object or object or object or object or object, required) — Errors occurred during authentication.
  - auth_apiv2.AuthError.invalid_access_token
    - `.tag` (enum, required)
      - Allowed values: `invalid_access_token`
  - auth_apiv2.AuthError.invalid_select_user
    - `.tag` (enum, required)
      - Allowed values: `invalid_select_user`
  - auth_apiv2.AuthError.invalid_select_admin
    - `.tag` (enum, required)
      - Allowed values: `invalid_select_admin`
  - auth_apiv2.AuthError.user_suspended
    - `.tag` (enum, required)
      - Allowed values: `user_suspended`
  - auth_apiv2.AuthError.expired_access_token
    - `.tag` (enum, required)
      - Allowed values: `expired_access_token`
  - auth_apiv2.AuthError.missing_scope
    - `.tag` (enum, required)
      - Allowed values: `missing_scope`
    - `required_scope` (string, required) — The required scope to access the route.
  - auth_apiv2.AuthError.route_access_denied
    - `.tag` (enum, required)
      - Allowed values: `route_access_denied`
  - Other
    - `.tag` (string, optional)
- `error_summary` (string, required) — A human-readable summary of the error.

### 403 Forbidden Error

The user or team account doesn't have access to the endpoint or feature

- `error` (object or object or object or object or object, required) — Error occurred because the account doesn't have permission to access the resource.
  - auth_apiv2.AccessError.invalid_account_type
    - `.tag` (enum, required)
      - Allowed values: `invalid_account_type`
    - `invalid_account_type` (object or object or object, required)
      - auth_apiv2.InvalidAccountTypeError.endpoint
        - `.tag` (enum, required)
          - Allowed values: `endpoint`
      - auth_apiv2.InvalidAccountTypeError.feature
        - `.tag` (enum, required)
          - Allowed values: `feature`
      - Other
        - `.tag` (string, optional)
  - auth_apiv2.AccessError.paper_access_denied
    - `.tag` (enum, required)
      - Allowed values: `paper_access_denied`
    - `paper_access_denied` (object or object or object, required)
      - auth_apiv2.PaperAccessError.paper_disabled
        - `.tag` (enum, required)
          - Allowed values: `paper_disabled`
      - auth_apiv2.PaperAccessError.not_paper_user
        - `.tag` (enum, required)
          - Allowed values: `not_paper_user`
      - Other
        - `.tag` (string, optional)
  - auth_apiv2.AccessError.team_access_denied
    - `.tag` (enum, required)
      - Allowed values: `team_access_denied`
  - auth_apiv2.AccessError.no_permission
    - `.tag` (enum, required)
      - Allowed values: `no_permission`
    - `no_permission` (object or object, required)
      - auth_apiv2.NoPermissionError.unauthorized_account_id_usage
        - `.tag` (enum, required)
          - Allowed values: `unauthorized_account_id_usage`
        - `unauthorized_account_ids` (list of string, required) — The account IDs that the caller does not have permission to use.
      - Other
        - `.tag` (string, optional)
  - Other
    - `.tag` (string, optional)
- `error_summary` (string, required) — A human-readable summary of the error.

### 409 Conflict Error

Endpoint-specific error

- `error` (object or object or object or object or object or object or object or object, required)
  - sharing_apiv2.MountFolderError.access_error
    - `.tag` (enum, required)
      - Allowed values: `access_error`
    - `access_error` (object or object or object or object or object or object, required) — There is an error accessing the shared folder.
      - sharing_apiv2.SharedFolderAccessError.invalid_id
        - `.tag` (enum, required)
          - Allowed values: `invalid_id`
      - sharing_apiv2.SharedFolderAccessError.not_a_member
        - `.tag` (enum, required)
          - Allowed values: `not_a_member`
      - sharing_apiv2.SharedFolderAccessError.invalid_member
        - `.tag` (enum, required)
          - Allowed values: `invalid_member`
      - sharing_apiv2.SharedFolderAccessError.email_unverified
        - `.tag` (enum, required)
          - Allowed values: `email_unverified`
      - sharing_apiv2.SharedFolderAccessError.unmounted
        - `.tag` (enum, required)
          - Allowed values: `unmounted`
      - Other
        - `.tag` (string, optional)
  - sharing_apiv2.MountFolderError.inside_shared_folder
    - `.tag` (enum, required)
      - Allowed values: `inside_shared_folder`
  - sharing_apiv2.MountFolderError.insufficient_quota
    - `.tag` (enum, required)
      - Allowed values: `insufficient_quota`
    - `space_left` (uint64, required) — The amount of space left in the user's Dropbox, less than space_needed.
    - `space_needed` (uint64, required) — The amount of space needed to add the item (the size of the item).
    - `space_shortage` (uint64, required) — The amount of extra space needed to add the item.
  - sharing_apiv2.MountFolderError.already_mounted
    - `.tag` (enum, required)
      - Allowed values: `already_mounted`
  - sharing_apiv2.MountFolderError.no_permission
    - `.tag` (enum, required)
      - Allowed values: `no_permission`
  - sharing_apiv2.MountFolderError.not_mountable
    - `.tag` (enum, required)
      - Allowed values: `not_mountable`
  - sharing_apiv2.MountFolderError.must_automount
    - `.tag` (enum, required)
      - Allowed values: `must_automount`
  - Other
    - `.tag` (string, optional)
- `error_summary` (string, required) — A human-readable summary of the error.
- `user_message` (object, optional)
  - `locale` (string, optional)
  - `text` (string, optional)

### 429 Too Many Requests Error

The app is making too many requests for the given user or team and is being rate limited. The app should wait for the number of seconds specified in the "Retry-After" response header before trying again.

- `error` (object, required) — Error occurred because the app is being rate limited.
  - `reason` (object or object or object, required) — The reason why the app is being rate limited.
    - auth_apiv2.RateLimitReason.too_many_requests
      - `.tag` (enum, required)
        - Allowed values: `too_many_requests`
    - auth_apiv2.RateLimitReason.too_many_write_operations
      - `.tag` (enum, required)
        - Allowed values: `too_many_write_operations`
    - Other
      - `.tag` (string, optional)
  - `retry_after` (uint64, optional, default: 1) — The number of seconds that the app should wait before making another request.
- `error_summary` (string, required) — A human-readable summary of the error.

### 500 Internal Server Error

Internal server error. An error occurred on the Dropbox servers. Check https://status.dropbox.com/ for announcements about Dropbox service issues.

- `any`

## Examples

**Request**

```json
{
  "shared_folder_id": null
}
```

**Response**

```json
{
  "access_type": {
    ".tag": "owner"
  },
  "is_inside_team_folder": false,
  "is_team_folder": false,
  "name": "dir",
  "policy": {
    "acl_update_policy": {
      ".tag": "owner"
    },
    "shared_link_policy": {
      ".tag": "anyone"
    },
    "member_policy": {
      ".tag": "anyone"
    },
    "resolved_member_policy": {
      ".tag": "team"
    }
  },
  "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
  "shared_folder_id": "84528192421",
  "time_invited": "2016-01-20T00:00:00Z",
  "access_inheritance": {
    ".tag": "inherit"
  },
  "folder_id": "id:a4ayc_80_OEAAAAAAAAAXw",
  "link_metadata": {
    "audience_options": [
      {
        ".tag": "public"
      },
      {
        ".tag": "team"
      },
      {
        ".tag": "members"
      }
    ],
    "current_audience": {
      ".tag": "public"
    },
    "link_permissions": [
      {
        "action": {
          ".tag": "change_audience"
        },
        "allow": true
      }
    ],
    "password_protected": false,
    "url": ""
  },
  "owner_display_names": [
    "Jane Doe"
  ],
  "owner_team": {
    "id": "dbtid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I",
    "name": "Acme, Inc."
  },
  "parent_folder_name": "Parent Shared Folder",
  "path_lower": "/dir",
  "permissions": []
}
```

**SDK Code**

```python
import requests

url = "https://api.dropboxapi.com/2/sharing/mount_folder"

payload = { "shared_folder_id": None }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.dropboxapi.com/2/sharing/mount_folder';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"shared_folder_id":null}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dropboxapi.com/2/sharing/mount_folder"

	payload := strings.NewReader("{\n  \"shared_folder_id\": null\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.dropboxapi.com/2/sharing/mount_folder")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"shared_folder_id\": null\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.dropboxapi.com/2/sharing/mount_folder")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"shared_folder_id\": null\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.dropboxapi.com/2/sharing/mount_folder', [
  'body' => '{
  "shared_folder_id": null
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.dropboxapi.com/2/sharing/mount_folder");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"shared_folder_id\": null\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = ["shared_folder_id": ] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.dropboxapi.com/2/sharing/mount_folder")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```