General:

• Add support for PKCE
• Add support for Short-Lived Tokens
• Add support for Scopes
• These features are all in beta, please contact Dropbox support if you are interested in these features
• Update Requirements.txt
• Add Github action to auto-publish to pypi

Breaking Changes:

• DropboxOAuth2Flow consumer_secret parameter moved to end of constructor as it became optional with support of PKCE
• Assertions in constructors have been mapped to their BadInputException

Files Namespace: - Update comments on FileLockMetadata struct - Add optional lockholder_account_id to FileLockMetadata struct - Add optional invalid_argument to SearchError union - Add get_thumbnail:2 route - Add ThumbnailV2Error union - Add MinimalFileLinkMetadata struct - Add PreviewResult struct - Add SharedLinkFileInfo struct - Add PathOrLink union - Add ThumbnailV2Arg struct - Change UnlockFileArg's path type to WritePathOrId - Change LockFileArg's path type to WritePathOrId

Shared Links Namespace: - Fix Typo

Team Groups Namespace: - Add add_creator_as_owner to GroupCreateArg struct - Update comments for async_job_id on GroupMembersChangeResult struct

Team Legal Holds Namespace: - Add exporting to LegalHoldStatus union - Add invactive_legal_hold to LegalHoldsListHeldRevisionsError union - Add legal_hold_policy_not_found to LegalHoldsPolicyUpdateError union - Add MembersInfo struct - Add LegalHoldsError union - mark legal_holds/export_policy to deprecated - mark legal_holds/export_policy_job_status/check to deprecated - Change LegalHoldPolicy's members type to MembersInfo - Update LegalHoldPolicy's examples - Update LegalHoldsPolicyCreateError to extend LegalHoldsError - Update LegalHoldsGetPolicyError to extend LegalHoldsError - Update LegalHoldsListPoliciesError to extend LegalHoldsError - Update LegalHoldsPolicyUpdateError to extend LegalHoldsError

Team Log Namespace: - Remove lifespan comment

Team Log Generated Namesapce: - Add team_invite_details to ActionDetails union - Add optional has_linked_apps to JoinTeamDetails struct - Add optional has_linked_devices to JoinTeamDetails struct - Add optional has_linkeD_shared_folders to JoinTeamDetails struct - Update comments in JoinTeamDetails struct - Update JoinTeamDetails struct examples - Update LegalHoldsExportAHoldDetails struct examples - Update PaperContentRemoveFromFolderDetails target_asset_index to be optional - Update PaperContentRemoveFromFolderDetails parent_asset_index to be optional - Add shared_content_link to SharedLinkSettingsAddExpirationDetails struct - Update SharedLinkSettingAddExpirationDetails struct examples - Add optional shared_content_link to SharedLinkSettingsAddPasswordDetails struct - Add optional shared_content_link to SharedLinkSettingsAllowDownloadDisabledDetails struct - Add optional shared_content_link to SharedLinkSettingsAllowDownloadEnabledDetails struct - Add optional shared_content_link to SharedLinkSettingsChangeAudienceDetails struct - Add optional shared_content_link to SharedLinkSettingsChangeExpirationDetails struct - Add optional shared_content_link to SharedLinkSettingsChangePasswordDetails struct - Add optional shared_content_link to SharedLinkSettingsRemoveExpirationDetails struct - Add optional shared_content_link to SharedLinkSettingsRemovePasswordDetails struct - Add file_locking_status_changed_details to EventDetails union - Add rewind_folder_details to EventDetails union - Add legal_holds_export_cancelled_details to EventDetails union - Add legal_holds_export_downloaded_details to EventDetails union - Add legal_holds_export_removed_details to EventDetails union - Add create_team_invite_link_details to EventDetails union - Add delete_team_invite_link_details to EventDetails union - Add binder_add_page_details to EventDetails union - Add binder_add_section_details to EventDetails union - Add binder_remove_page_details to EventDetails union - Add binder_remove_section_details to EventDetails union - Add binder_rename_page_details to EventDetails union - Add binder_rename_section_details to EventDetails union - Add binder_reorder_page_details to EventDetails union - Add binder_reorder_section_details to EventDetails union - Add rewind_policy_changed_details to EventDetails union - Add team_sharing_whitelist_subjects_changed_details to EventDetails union - Add web_sessions_change_active_session_limit_details to EventDetails union - Add enterprise_settings_locking_details to EventDetails union - Add file_locking_lock_status_changed to EventType union - Add rewind_folder to EventType union - Add legal_holds_export_cancelled to EventType union - Add legal_holds_export_downloaded to EventType union - Add legal_holds_export_removed to EventType union - Add create_team_invite_link to EventType union - Add delete_team_invite_link to EventType union - Add binder_add_page to EventType union - Add binder_add_section to EventType union - Add binder_remove_page to EventType union - Add binder_remove_section to EventType union - Add binder_rename_page to EventType union - Add binder_rename_section to EventType union - Add binder_reorder_page to EventType union - Add binder_reorder_section to EventType union - Add rewind_policy_changed to EventType union - Add team_sharing_whitelist_subjects_changed to EventType union - Add web_sessions_change_active_session_limit to EventType union - Add enterprise_settings_locking to EventType union - Add TeamInviteDetails struct - Add InviteMethod union - Add LockStatus union - Add RewindPolicy union - Add FileLockingLockStatusChangedDetails struct - Add RewindFolderDetails struct - Add LegalHoldsExportCancelledDetails struct - Add LegalHoldsExportDownloadedDetails struct - Add LegalHoldsExportRemovedDetails struct - Add CreateTeamInviteLinkDetails struct - Add DeleteTeamInviteLinkDetails struct - Add BinderAddPageDetails struct - Add BinderAddSectionDetails struct - Add BinderRemovePageDetails struct - Add BinderRemoveSectionDetails struct - Add BinderRenamePageDetails struct - Add BinderRenameSectionDetails struct - Add BinderReorderPageDetails struct - Add BinderReorderSectionDetails struct - Add RewindPolicyChangedDetails struct - Add TeamSharingWhitelistSubjectsChangedDetails struct - Add WebSessionsChangeActiviteSessionLimitDetails struct - Add EnterpriseSettingsLockingDetails struct - Add FileLockingLockStatusChangedType struct - Add RewindFolderType struct - Add LegalHoldsExportCancelledType struct - Add LegalHoldsExportDownloadedType struct - Add LegalHoldsExportRemovedType struct - Add CreateTeamInviteLinkType struct - Add DeleteTeamInviteLinkType struct - Add BinderAddPageType struct - Add BinderAddSectionType struct - Add BinderRemovePageType struct - Add BinderRemoveSectionType struct - Add BinderRenamePageType struct - Add BinderRenameSectionType struct - Add BinderReorderPageType struct - Add BinderReorderSectionType struct - Add RewindPolicyChangedType struct - Add TeamSharingWhitelistSubjectsChangedType struct - Add WebSessionsChangeActiveSessionLimitType struct - Add EnterpriseSettingsLockingType struct

Users Namespace: - Add file_locking to UserFeature union - Add file_locking to UserFeatureValue - Update example for UserFeaturesGetaluesBatchArg - Add FileLockingValue union

auth Namespace:

• Added missing_scope into AuthError.

file_requests namespace:

• Added list and list/continue endpoints.
• Added count endpoint.
• Added delete and delete_all_closed endpoints.

files namespace:

• Added unsupported_file to DownloadError.
• Added upper bound 9999 to start field in SearchArg.
• Added unsupported_content_type to LookupError.
• Added cant_move_shared_folder to RelocationError.
• Added email_not_verified and unsupported_file to GetTemporaryLinkError.
• Added ExportInfo struct.
• Added fields (is_downloadable, export_info) to FileMetadata.
• Added include_non_downloadable_files to ListFolderArg.
• Added ExportMetadata, ExportArg, Export Result Structs.
• Added ExportError union.
• Added /export route.

seen_state namespace:

• Added mobile_ios, mobile_android and api into PlatformType.
• Deprecated mobile in PlatformType.

sharing namespace:

• Updated shared_link_already_exists under CreateSharedLinkWithSettingsError from void to SharedLinkAlreadyExistsMetadata.
• Updated docstrings for LinkPermissions
• Added banned_member to AddFolderMemberError.
• Added password field to LinkAudience.
• Added effective_audience and link_access_level fields to LinkPermissions struct.
• Added audience and access fields to SharedLinkSettings struct.
• Added LinkAccessLevel and RequestedLinkAccessLevel union.
• Added create_view_link and create_edit_link fields to FileAction union.

team namespace:

• Added profile_photo_url and suspended_on into MemberProfile.

team_log namespace:

• Added various new types.

team_policies namespace:

• Added TwoStepVerificationState union.

team_reports namespace:

• Added TemporaryFailureReason union.

Common Namespace:

• Force matching dot character in alias EmailAddress.

File_properties namespace:

• Doesn’t allow app folder app to access file property endpoints.

Files namespace:

• Create copy_batch:2 and move_batch:2 endpoints. Deprecate existing copy_batch and move_batch.

Sharing_files namespace:

• Doesn’t allow app folder app to access sharing files endpoints.

Team namespace:

• Only Team apps with Team member file access can access team/properties endpoints.

Common Namespace:

• Allow DisplayNameLegacy to support a name of zero chars

Contacts namespace:

• New namespace
• New routes: delete_manual_contacts and delete_manual_contacts_batch
• New argument structs for new routes

Sharing namespace:

• Add no_one option to LinkAudience union

Teams namespace:

• Add is_disconnected boolean to RemovedStatus struct
• Add error response type to namespace/list route

Team_log namespace:

• New event types added

files Namespace:

• Updated doc strings

team_log Namespace:

• Updated event docstrings
• New reset field for loading events with a cursor
• New event types added

team_policies Namespace:

• New CameraUploadsPolicyState union

• Fixed mappings of business API endpoints to the right object.
• Added escaping for namespaces with keyword names.

Files Namespace:

• new documentation
• added new too_large error type for uploads

Team namespace:

• add is_directory_restricted attribute to MemberProfile, MemberAddArg
• add new_is_directory_restricted to MemberSetProfileArg

Team_log namespace:

• additional documentation

• Fixed Sphinx documentation entires.
• Added missing namespace: seen_state.
• Removed deleted namespace: properties.

file_properties namespace:

• updated comments

files namespace:

• new FileId alias
• new SymlinkInfo struct on FileMetadata
• added select_admin_mode attribute to relevant routes
• added too_many_write_operations error type to WriteError
• New CreateFolderBatch endpoint and related datatypes
• Added parent_rev attribute to DeleteArg
• New Thumbnail sizes
• New ThumbnailMode object
• New SyncSettings objects

sharing namespace:

• added select_admin_mode attribute to relevant routes
• add seen_State.PlatformType to UserFileMembershipInfo
• new set_access_inheritance for FolderAction
• Updated docs
• additional user info added to UserInfo struct
• new AccessInheritance union
• new set_access_inheritance route

team namespace:

• updated docstrings
• new HasTeamSelectiveSync object
• new selective sync settings included in various return objects and error types
• new update_sync_settings route

team_log namespace:

• updated event types

team_policies namespace:

• new ShowcaseEnabledPolicy object
• new ShowcaseDownloadPolicy object
• new ShowcaseExternalSharingPolicy object

users namespace:

• updated routes with select_admin_mode attribute.

Fix regression in Dropbox.as_admin() and Dropbox.as_user()

Added with_path_root helper utility to Dropbox base class to facility stetting Dropbox-API-Path-Root header. See https://www.dropbox.com/developers/reference/namespace-guide#pathrootmodes for more information about the path root header.

team_common namespace:

• Added new MemberSpaceLimitType union

team namespace:

• add additional error types to MembersRemoveError union
• updated docstring

users namespace:

• additional member space limit fields in TeamSpaceAllocation struct

team_log namespace:

• lots of updates to struct names and descriptions (note these routes and structs are still in preview and subject to further changes)

Release Notes:

• files namespace
  • Add download_zip endpoint
  • Add properties_error to UploadError
• team_log namespace
  • Add more event types

Release Notes:

Namespace Common:

• New PathRoot and RootInfo related structs and unions

Namespace File_properties:

• additional documentation
• new RemoveTemplateArg struct
• new routes for templates
• updated TemplateFilter union
• new PropertiesSearch structs
• new properties/search/continue route

Namespace Files:

• updated documentation
• updated routes with support for select_admin_mode
• add include_property_groups attribute to to args structs
• add propert_groups attribute to response structs

Namespace Sharing:

• update routes to include indicate for select_admin_mode
• updated examples
• add too_many_files attribute to RemoveFolderMemberError

Namespace Team:

• add new has_file_events input/output structs to featres/get_values endpoint
• add additional examples for device related structs
• reduce minimum value for UserQuota to 15
• Updated QuotaError structs
• New structs and routes to support excluded_users

Namespace Team_policies:

• add new SmartSyncPolicy union

Namespace Users:

• add root_info object to FullAccount struct

Release Notes

Merged https://github.com/dropbox/dropbox-sdk-python/pull/127 to remove explicitly setting SSL flags and instead rely on urllib3 defaults

update required requests version to 2.16.2+

2.16.0 is the first version of requests to explicitly depend on urllib3, though there are problems with 2.16.0 and 2.16.1. Requiring 2.16.2 allows us to remove our explicit dependency on urllib3 and instead let requests drive the version of urllib3 to install. This should resolve errors where users have older conflicting versions of requests and urllib3 installed.

Spec Changes:

• Move shared_link to end of parameter list for ListFolderArg.
• Add mode to ListRevisionsArg.

Release notes from Stone Spec

General:

• Updated docstrings in multiple namespaces
• Updated general route configuration to support select_admin_mode

file_properties namespace:

• New routes and structs for the file properties and templates API functionality

file_requests namespace:

• New routes and structs for the file_requests API functionality

files:

• deprecate preview routes for files_properties

files_properties:

• removed in favor of file_properties

properties:

• removed in favor of file_properties

team_property_templates:

• removed in favor of file_properties

team:

• deprecate beta properites routes

team_members:

• Update NamePart? to be OptionalNamePart?

team_policies:

• Add new team policies for SSO Paper, RolloutMethod and PasswordStrength

Release Notes from stone spec:

General:

• Numerous updates to docstrings across all namespaces.

Common Namespace:

• New aliases for OptionalNamePart and DisplayNameLegacy

Files Namespace:

• New attributes for ListFolderArg: included_mounted_folders, limit
• New get_thumbnail_batch route and corresponding interfaces.

Paper Namespace:

• New "docs/create" and "docs/update" routes and corresponding interfaces.

Sharing_Folders namespace:

• Updated PermissionDeniedReason union

Team_Log Namespace

• Reduced strictness of pattern matching for IpAddress
• New FileCommentNotificationPolicy union
• Multiple updated attribute names in unions.
• New Structs for new team_log objects

Team namespace:

New routes & corresponding interfaces:
    member_space_limits/set_custom_quota
    member_space_limits/remove_cusom_quota
    member_space_limits/get_custom_quota

• Updated Stone
• Fix host for calls to /oauth2/authorize (#109)
• Remove support for API v1 (#96)

Common namespace:

• Added PathRootError.

Files namespace:

• Added too_many_write_operations in UploadSessionFinishError.
• Removed PathRootError and invalid_path_root in LookupError. (breaking change)
• Added team_folder to WriteError.

Sharing namespace:

• Added access_level to LinkSettings.
• Added change_access_level to LinkAction.
• Added access_level and audience_restricting_shared_folder to SharedContentLinkMetadataBase.
• Added access_type and expected_link_metadata to SharedFileMetadata.
• Added path to ParentFolderAccessInfo.
• Added actions to UpdateFolderPolicyArg.
• Added team_folder to UpdateFolderPolicyError.

Stone Cfg namespace:

• Added allow_app_folder_app attribute.
• Added takes_path_root attribute.

Team namespace:

• Added route token/get_authenticated_admin.
• Added route features/get_values.
• Added expires to ActiveWebSession.
• Added cursor and has_more to TeamFolderListResult for pagination.
• Added route team_folder/list/continue.
• Made member_given_name and member_surname optional in MemberAddArg. (breaking change)

User namepsace:

• Moved AccountType from user namespace to user_common namespace.

Added TeamLog namespace.

Added Paper namespace.

Files namespace:

• Added Sha256HexHash alias.
• Added content_hash to FileMetadata.
• Added upload_api_rate_limit feature attribute to upload_session/start, upload_session/append_v2, upload_session/append, upload, upload_session/finish_batch.
• Added duplicated_or_nested_paths to RelocationError and removed from RelocationBatchError.
• Added properties api_group attribute and is_preview attribute to properties/*.
• Added disable_viewer_info and enable_viewer_info to CommitInfoWithProperties.
• Added link_metadata to SharedFileMetadata.
• Added ViewerInfoPolicy union.
• Added no_explicit_access to MemberSelector.
• Deprecated change_file_member_access.
• Added update_file_member route and UpdateFileMemberArgs struct.

Sharing namespace:

• Added viewer_info_policy, disable_viewer_info, enable_viewer_info to FolderPolicy.
• Added team, is_inside_team_folder, path_lower to SharedLinkPolicy.
• Added link_metadata, policy, shared_folder_id, time_invited to SharedFolderMetadata.
• Added actions, link_settings, viewer_info_policy to ShareFolderArg and removed default values from policies in ShareFolderArg.
• Added viewer_info_policy, link_settings to UpdateFolderPolicyArg.

Stone Cfg namespace:

• Added attribute api_group, is_preview.
• Removed attributes alpha_group, beta_group.

Team namespace:

• Added joined_on, persistent_id to MemberProfile.
• Added team_member_id, external_id to UserSelectorArg.
• Added TeamMemberId, MemberExternalId, GroupExternalId, ResellerId aliases.
• Added company_managed, system_managed to GroupManagementType.
• Added TimeRange.
• Added archive_in_progress to TeamFolderStatus, TeamFolderIdArg.
• Added BaseTeamFolderError.
• Added folder_name_reserved to TeamFolderCreateError.
• TeamFolderRenameError, TeamFolderArchiveError, BaseTeamFolderError, TeamFolderPermanentlyDeleteError now extend BaseTeamFolderError.
• Added folder_name_reserved to TeamFolderRenameError.
• Added GroupSelectorWithTeamGroupError.
• GroupMemberSelectorError, GroupMembersSelectorError now extends GroupSelectorWithTeamGroupError.
• Removed alpha from alpha/groups/*.
• GroupDeleteError, GroupUpdateError, GroupMembersAddError now extends GroupSelectorWithTeamGroupError.
• Added members_not_in_team, users_not_found to GroupMembersAddError.
• Added joined_on to TeamMemberProfile.
• Added member_persistent_id, duplicate_member_persistent_id, persistent_id_disabled, new_persistent_id, persistent_id_disabled, persistent_id_used_by_other_user to MemberSelectorError.

1. File upload endpoints no longer accept file-like objects. Only byte strings are allowed. This helps prevent errors in previous versions where automatic request retries would use the next part of the stream rather than re-using the portion that was rejected.
2. The return value of the OAuth flows are now an object that includes account_id rather than a tuple. Please use account_id (v2 concept) rather than user_id (v1 concept). This will improve future extensibility.

Auth namespace:

• Added user_suspended to AuthError.

Files namespace:

• Added PathRootError.
• Added invalid_path_root to LookupError.
• Added autorename to CreateFolderArg.
• Added DeleteBatchArg, DeleteBatchResultEntry, DeleteResult, DeleteBatchResult, DeleteBatchError and DeleteBatchJobStatus.
• Added delete_batch and delete_batch/check routes.
• Added RelocationPath.
• Added to allow_shared_folder and autorename to RelocationArg.
• Added RelocationBatchArg, RelocationBatchResult, RelocationBatchJobStatus. RelocationResult and RelocationBatchError.
• Added copy_batch and copy_batch/check routes.
• Added move_batch and move_batch/check routes.

Sharing namespace:

• Changed PathOrId validation pattern.
• Changed path in ShareFolderArg from type files.Path to files.WritePath.
• Added contains_app_folder, contains_team_folder and invalid_path_root to ShareFolderArg.

Stone Cfg namespace:

• Changed validation pattern for owner in Route.

Team namespace:

• Added team_license_limit to MembersRecoverError.
• Removed beta_group attribute from members/recover.

• Improved docstrings for route methods and types.

You can now see more details when getting an auth or rate limit error. For example, you can inspect why the rate limit error occurred (too many requests or too many write operations).

Bug in requests v2.6.1 causes chunked responses to not be properly decompressed. Issue found in #71.

Stone specs:

• Updated to new stone spec format (unions are default open).

Auth namespace:

• Added RateLimitReason and RateLimitError for describing 429 responses.

Files namespace:

• Added upload_session/finish_batch route.

Sharing namespace:

• Added change_member_file_access route.
• Added invite_view_no_comment to FolderPolicy.
• Added share_link to FolderAction.
• Added make_viewer_no_comment to MemberAction.
• Added preview_url to SharedFolderMetadata.
• Added access_details to MemberAccessLevelResult, which is the parent folders that amember has access to.
• Added too_many_invitees error to AddFolderMemberError.
• Added automatic_group to AddMemberSelectorError.
• Added insufficient_quota to MountFolderError.
• Added removed to TeamMemberStatus.

Team namespace:

• Added new_group_management_type to GroupUpdateArgs for groups/delete.
• Added include_removed flag to MembersListArg
• Added members/recover route.

Other changes:

• sharing/remove_folder_member only ever returns an async_job_id.
• sharing/check_remove_member_job_status returns a MemberAccessLevelResult on completion.
• sharing/update_folder_member returns a MemberAccessLevelResult on completion.
• no_explicit_access information added to UpdateFolderMemberError.

- Files
  - Add save_url endpoint for saving online content to your Dropbox.
- Shared folders
  - Add viewer_no_comment to AccessLevel.
  - Add is_owner to GroupInfo.
  - Change return type of SharePathError.already_shared from Void to SharedFolderMetadata.
  - Add leave_a_copy parameter to relinquish_folder_membership endpoint.
  - Change relinquish_folder_membership to return async job ID when leaving a copy.
  - Add relinquish_folder_membership_error to JobError.
- Business endpoints
  - Add membership_type to MemberProfile.
  - Add keep_account parameter to members/remove endpoint.
  - Add cannot_keep_account_and_transfer and cannot_keep_account_and_delete_data to MembersRemoveError.

Change log:

• Authentication
  • Add token/revoke endpoint.
• Account
  • Add disabled field to Account.
• Files
  • Add include_deleted and include_has_explicit_shared_members parameter to get_metadata and list_f
  • Add close parameter to upload_session/start endpoint to support explicitly close an upload sessi
  • Add upload_session/append_v2 endpoint which provides explicit session close support. upload_sess
  • Add copy_reference endpoint.
  • Add get_temporary_link endpoint.
• Shared links
  • Add remove_expiration parameter to modify_shared_link_settings endpoint.
• Shared folders
  • Add leave_a_copy to FolderAction.
  • Add time_invited to SharedFolderMetadata.
  • Return is_osx_package or inside_osx_package error when user attempts to share an OS X package or
• Business endpoints
  • member_count is now optional in GroupSummary.
  • devices/list_team_devices endpoint is now deprecated by devices/list_member_devices.
  • linked_apps/list_team_linked_apps is now deprecated by linked_apps/list_members_linked_apps endp
  • Add return_members parameter to groups/members/set_access_type endpoint.

Change log:

• Updated documentation.
• Added removed_member_policy field to FolderPolicy.
• Added group_type field to GroupInfo.
• Added owner_team and parent_shared_folder_id field to SharedFolderMetadataBase.
• Added not_mountable to MountFolderError.
• Added not_unmountable to UnmountFolderError.
• Added validation for member external id and email address.
• Added shared_link_create_policy field to TeamSharingPolicies.
• Added team_license_limit to MembersSuspendError and MembersUnsuspendError.