> 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. # List Folders POST https://api.dropboxapi.com/2/sharing/list_folders Content-Type: application/json Return the list of all shared folders the current user has access to. **Required scope:** `sharing.read` **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/list-folders ## Authentication - `Authorization` header (bearer token, required) — OAuth 2.0 token issued to a specific user. Use `Authorization: Bearer `. 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": ""}`, or `{".tag": "namespace_id", "namespace_id": ""}`. On failure the request returns 422 with a `common.PathRootError`. ### Body (application/json) This endpoint expects an object. - `actions` (list of 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) — A list of `FolderAction`s corresponding to `FolderPermission`s that should appear in the response's `SharedFolderMetadata.permissions` field describing the actions the authenticated user can perform 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` - `limit` (uint, optional, default: 1000) — The maximum number of results to return per request. ## Response ### 200 Successful response - `entries` (list of object, required) — List of all shared folders the authenticated user has access to. - `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) - `cursor` (string, optional, nullable) — Present if there are additional shared folders that have not been returned yet. Pass the cursor into the corresponding continue endpoint (either [list_folders/continue](api:dropbox-api:POST/2/sharing/list_folders/continue) or [list_mountable_folders/continue](api:dropbox-api:POST/2/sharing/list_mountable_folders/continue)) to list additional folders. ## 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 No endpoint-specific errors - `any` ### 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 { "actions": [], "limit": 100 } ``` **Response** ```json { "entries": [ { "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": [] } ], "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu" } ``` **SDK Code** ```python import requests url = "https://api.dropboxapi.com/2/sharing/list_folders" payload = { "actions": [], "limit": 100 } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.dropboxapi.com/2/sharing/list_folders'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"actions":[],"limit":100}' }; 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/list_folders" payload := strings.NewReader("{\n \"actions\": [],\n \"limit\": 100\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") 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/list_folders") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"actions\": [],\n \"limit\": 100\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.dropboxapi.com/2/sharing/list_folders") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"actions\": [],\n \"limit\": 100\n}") .asString(); ``` ```php request('POST', 'https://api.dropboxapi.com/2/sharing/list_folders', [ 'body' => '{ "actions": [], "limit": 100 }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.dropboxapi.com/2/sharing/list_folders"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"actions\": [],\n \"limit\": 100\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "actions": [], "limit": 100 ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.dropboxapi.com/2/sharing/list_folders")! 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() ```