Update public spec.

- 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.

Author: braincore

dropbox/auth.py

@@ -20,6 +20,8 @@ class AuthError(bb.Union):
     :ivar invalid_access_token: The access token is invalid.
     :ivar invalid_select_user: The user specified in 'Dropbox-API-Select-User'
         is no longer on the team.
+    :ivar invalid_select_admin: The user specified in 'Dropbox-API-Select-Admin'
+        is not a Dropbox Business team admin.
     :ivar other: An unspecified error.
     """
 
@@ -29,6 +31,8 @@ class AuthError(bb.Union):
     # Attribute is overwritten below the class definition
     invalid_select_user = None
     # Attribute is overwritten below the class definition
+    invalid_select_admin = None
+    # Attribute is overwritten below the class definition
     other = None
 
     def is_invalid_access_token(self):
@@ -47,6 +51,14 @@ def is_invalid_select_user(self):
         """
         return self._tag == 'invalid_select_user'
 
+    def is_invalid_select_admin(self):
+        """
+        Check if the union tag is ``invalid_select_admin``.
+
+        :rtype: bool
+        """
+        return self._tag == 'invalid_select_admin'
+
     def is_other(self):
         """
         Check if the union tag is ``other``.
@@ -62,15 +74,18 @@ def __repr__(self):
 
 AuthError._invalid_access_token_validator = bv.Void()
 AuthError._invalid_select_user_validator = bv.Void()
+AuthError._invalid_select_admin_validator = bv.Void()
 AuthError._other_validator = bv.Void()
 AuthError._tagmap = {
     'invalid_access_token': AuthError._invalid_access_token_validator,
     'invalid_select_user': AuthError._invalid_select_user_validator,
+    'invalid_select_admin': AuthError._invalid_select_admin_validator,
     'other': AuthError._other_validator,
 }
 
 AuthError.invalid_access_token = AuthError('invalid_access_token')
 AuthError.invalid_select_user = AuthError('invalid_select_user')
+AuthError.invalid_select_admin = AuthError('invalid_select_admin')
 AuthError.other = AuthError('other')
 
 token_revoke = bb.Route(
@@ -79,8 +94,8 @@ def __repr__(self):
     bv.Void(),
     bv.Void(),
     bv.Void(),
-    {'host': None,
-     'style': None},
+    {'host': u'api',
+     'style': u'rpc'},
 )
 
 ROUTES = {

dropbox/base.py

@@ -10,6 +10,7 @@
     properties,
     sharing,
     team,
+    team_common,
     team_policies,
     users,
 )
@@ -538,8 +539,8 @@ def files_list_folder_longpoll(self,
                                    timeout=30):
         """
         A longpoll endpoint to wait for changes on an account. In conjunction
-        with :meth:`list_folder`, this call gives you a low-latency way to
-        monitor an account for file changes. The connection will block until
+        with :meth:`list_folder_continue`, this call gives you a low-latency way
+        to monitor an account for file changes. The connection will block until
         there are changes available or a timeout occurs. This endpoint is useful
         mostly for client-side apps. If you're looking for server-side
         notifications, check out our `webhooks documentation
@@ -665,6 +666,54 @@ def files_restore(self,
         )
         return r
 
+    def files_save_url(self,
+                       path,
+                       url):
+        """
+        Save a specified URL into a file in user's Dropbox. If the given path
+        already exists, the file will be renamed to avoid the conflict (e.g.
+        myfile (1).txt).
+
+        :param str path: The path in Dropbox where the URL will be saved to.
+        :param str url: The URL to be saved.
+        :rtype: :class:`dropbox.files.SaveUrlResult`
+        :raises: :class:`dropbox.exceptions.ApiError`
+
+        If this raises, ApiError.reason is of type:
+            :class:`dropbox.files.SaveUrlError`
+        """
+        arg = files.SaveUrlArg(path,
+                               url)
+        r = self.request(
+            files.save_url,
+            'files',
+            arg,
+            None,
+        )
+        return r
+
+    def files_save_url_check_job_status(self,
+                                        async_job_id):
+        """
+        Check the status of a :meth:`save_url` job.
+
+        :param str async_job_id: Id of the asynchronous job. This is the value
+            of a response returned from the method that launched the job.
+        :rtype: :class:`dropbox.files.SaveUrlJobStatus`
+        :raises: :class:`dropbox.exceptions.ApiError`
+
+        If this raises, ApiError.reason is of type:
+            :class:`dropbox.files.PollError`
+        """
+        arg = async.PollArg(async_job_id)
+        r = self.request(
+            files.save_url_check_job_status,
+            'files',
+            arg,
+            None,
+        )
+        return r
+
     def files_search(self,
                      path,
                      query,
@@ -1423,28 +1472,34 @@ def sharing_mount_folder(self,
         return r
 
     def sharing_relinquish_folder_membership(self,
-                                             shared_folder_id):
+                                             shared_folder_id,
+                                             leave_a_copy=False):
         """
         The current user relinquishes their membership in the designated shared
         folder and will no longer have access to the folder.  A folder owner
-        cannot relinquish membership in their own folder. Apps must have full
-        Dropbox access to use this endpoint.
+        cannot relinquish membership in their own folder. This will run
+        synchronously if leave_a_copy is false, and asynchronously if
+        leave_a_copy is true. Apps must have full Dropbox access to use this
+        endpoint.
 
         :param str shared_folder_id: The ID for the shared folder.
-        :rtype: None
+        :param bool leave_a_copy: Keep a copy of the folder's contents upon
+            relinquishing membership.
+        :rtype: :class:`dropbox.sharing.LaunchEmptyResult`
         :raises: :class:`dropbox.exceptions.ApiError`
 
         If this raises, ApiError.reason is of type:
             :class:`dropbox.sharing.RelinquishFolderMembershipError`
         """
-        arg = sharing.RelinquishFolderMembershipArg(shared_folder_id)
+        arg = sharing.RelinquishFolderMembershipArg(shared_folder_id,
+                                                    leave_a_copy)
         r = self.request(
             sharing.relinquish_folder_membership,
             'sharing',
             arg,
             None,
         )
-        return None
+        return r
 
     def sharing_remove_folder_member(self,
                                      shared_folder_id,