Automated Spec Update (#378)

e57f8a4da1b070bed3ac5d4d3ec325fcd3630686

 Change Notes:

sharing_files Namespace
- Update Comments

sharing_folders Namespace
- Update Comments

team_folders Namespace
- Update Comments

team_log_generated Namespace
- Add ExternalDriveBackupPolicy union
- Add ExternalDriveBackupPolicyChangedDetails and ExternalDriveBackupPolicyChangedType structs
- Update EventDetails union to include external_drive_backup_policy_changed_details
- Update EventType union to include external_drive_backup_policy_changed
- Update EventTypeArg union to include external_drive_backup_policy_changed

team_policies Namespace
- Add ExternalDriveBackupPolicyState union

Co-authored-by: DropboxBot <[email protected]>

Author: DropboxBot

dropbox/base.py

@@ -4668,7 +4668,8 @@ def sharing_relinquish_folder_membership(self,
 
         :param str shared_folder_id: The ID for the shared folder.
         :param bool leave_a_copy: Keep a copy of the folder's contents upon
-            relinquishing membership.
+            relinquishing membership. This must be set to false when the folder
+            is within a team folder or another shared folder.
         :rtype: :class:`dropbox.sharing.LaunchEmptyResult`
         :raises: :class:`.exceptions.ApiError`
 
@@ -4758,8 +4759,9 @@ def sharing_remove_folder_member(self,
         :type member: :class:`dropbox.sharing.MemberSelector`
         :param bool leave_a_copy: If true, the removed user will keep their copy
             of the folder after it's unshared, assuming it was mounted.
-            Otherwise, it will be removed from their Dropbox. Also, this must be
-            set to false when kicking a group.
+            Otherwise, it will be removed from their Dropbox. This must be set
+            to false when removing a group, or when the folder is within a team
+            folder or another shared folder.
         :rtype: :class:`dropbox.sharing.LaunchResultBase`
         :raises: :class:`.exceptions.ApiError`
 

dropbox/base_team.py

@@ -2332,7 +2332,8 @@ def team_team_folder_archive(self,
                                  force_async_off=False):
         """
         Sets an active team folder's status to archived and removes all folder
-        and file members. Permission : Team member file access.
+        and file members. This endpoint cannot be used for teams that have a
+        shared team space. Permission : Team member file access.
 
         :param bool force_async_off: Whether to force the archive to happen
             synchronously.
@@ -2375,8 +2376,9 @@ def team_team_folder_create(self,
                                 name,
                                 sync_setting=None):
         """
-        Creates a new, active, team folder with no members. Permission : Team
-        member file access.
+        Creates a new, active, team folder with no members. This endpoint can
+        only be used for teams that do not already have a shared team space.
+        Permission : Team member file access.
 
         :param str name: Name for the new team folder.
         :param Nullable[:class:`dropbox.team.SyncSettingArg`] sync_setting: The
@@ -2464,7 +2466,8 @@ def team_team_folder_list_continue(self,
     def team_team_folder_permanently_delete(self,
                                             team_folder_id):
         """
-        Permanently deletes an archived team folder. Permission : Team member
+        Permanently deletes an archived team folder. This endpoint cannot be
+        used for teams that have a shared team space. Permission : Team member
         file access.
 
         :param str team_folder_id: The ID of the team folder.

dropbox/sharing.py

@@ -7034,7 +7034,8 @@ class RelinquishFolderMembershipArg(bb.Struct):
     :ivar sharing.RelinquishFolderMembershipArg.shared_folder_id: The ID for the
         shared folder.
     :ivar sharing.RelinquishFolderMembershipArg.leave_a_copy: Keep a copy of the
-        folder's contents upon relinquishing membership.
+        folder's contents upon relinquishing membership. This must be set to
+        false when the folder is within a team folder or another shared folder.
     """
 
     __slots__ = [
@@ -7366,8 +7367,9 @@ class RemoveFolderMemberArg(bb.Struct):
         folder.
     :ivar sharing.RemoveFolderMemberArg.leave_a_copy: If true, the removed user
         will keep their copy of the folder after it's unshared, assuming it was
-        mounted. Otherwise, it will be removed from their Dropbox. Also, this
-        must be set to false when kicking a group.
+        mounted. Otherwise, it will be removed from their Dropbox. This must be
+        set to false when removing a group, or when the folder is within a team
+        folder or another shared folder.
     """
 
     __slots__ = [
@@ -10689,7 +10691,8 @@ class UserFileMembershipInfo(UserMembershipInfo):
     last seen timestamp.
 
     :ivar sharing.UserFileMembershipInfo.time_last_seen: The UTC timestamp of
-        when the user has last seen the content, if they have.
+        when the user has last seen the content. Only populated if the user has
+        seen the content and the caller has a plan that includes viewer history.
     :ivar sharing.UserFileMembershipInfo.platform_type: The platform on which
         the user has last seen the content, or unknown.
     """