Automated Spec Update (#394)

6e0a08f15d3f28359208e079656780789361a95f Change Notes: files Namespace - Update list_folder route to include app auth - Update list_folder/continue route to include app auth - Update Examples Add file_tagging Namespace Co-authored-by: DropboxBot <[email protected]>
dropbox · Nov 3, 2021 · 0eddf8b · 0eddf8b
1 parent 0f71807
commit 0eddf8b
Show file tree

Hide file tree

Showing 3 changed files with 601 additions and 3 deletions.
diff --git a/dropbox/base.py b/dropbox/base.py
@@ -2775,6 +2775,76 @@ def files_search_continue_v2(self,
         )
         return r
 
+    def files_tags_add(self,
+                       path,
+                       tag_text):
+        """
+        Add a tag to an item. A tag is a string. No more than 20 tags can be
+        added to a given item.
+
+        :param str path: Path to the item to be tagged.
+        :param str tag_text: The value of the tag to add.
+        :rtype: None
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.files.AddTagError`
+        """
+        arg = files.AddTagArg(path,
+                              tag_text)
+        r = self.request(
+            files.tags_add,
+            'files',
+            arg,
+            None,
+        )
+        return None
+
+    def files_tags_get(self,
+                       paths):
+        """
+        Get list of tags assigned to items.
+
+        :param List[str] paths: Path to the items.
+        :rtype: :class:`dropbox.files.GetTagsResult`
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.files.BaseTagError`
+        """
+        arg = files.GetTagsArg(paths)
+        r = self.request(
+            files.tags_get,
+            'files',
+            arg,
+            None,
+        )
+        return r
+
+    def files_tags_remove(self,
+                          path,
+                          tag_text):
+        """
+        Remove a tag from an item.
+
+        :param str path: Path to the item to tag.
+        :param str tag_text: The tag to remove.
+        :rtype: None
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.files.RemoveTagError`
+        """
+        arg = files.RemoveTagArg(path,
+                                 tag_text)
+        r = self.request(
+            files.tags_remove,
+            'files',
+            arg,
+            None,
+        )
+        return None
+
     def files_unlock_file_batch(self,
                                 entries):
         """