Spec Update 03/30/2022 (#69)

Change Notes:

file_properties Namespace
- Update Comments

file_tagging Namespace
- Update Comments

files Namespace
- Update Metadata struct to include preview_url
- Update Comments

team_log_generated Namespace
- Add DropboxPasswordsPolicyChangedDetails, DropboxPasswordsPolicyChangedType structs
- Add DropboxPasswordsPolicy unions

Author: mover333

file_properties.stone

@@ -146,8 +146,7 @@ union LookupError
     not_folder
         "We were expecting a folder, but the given path refers to something that isn't a folder."
     restricted_content
-        "The file cannot be transferred because the content is restricted.  For example,
-        sometimes there are legal restrictions due to copyright claims."
+        "The file cannot be transferred because the content is restricted. For example, we might restrict a file due to legal requirements."
 
 union LookUpPropertiesError
     property_group_not_found

file_tagging.stone

@@ -45,7 +45,7 @@ union AddTagError extends BaseTagError
         "The item already has the maximum supported number of tags."
 
 route tags/add(AddTagArg, Void, AddTagError)
-    "Add a tag to an item. A tag is a string. No more than 20 tags can be added to a given item."
+    "Add a tag to an item. A tag is a string. The strings are automatically converted to lowercase letters. No more than 20 tags can be added to a given item."
 
     attrs
         auth = "user"

files.stone

@@ -64,6 +64,9 @@ struct Metadata
         "Please use :field:`FileSharingInfo.parent_shared_folder_id`
         or :field:`FolderSharingInfo.parent_shared_folder_id` instead."
 
+    preview_url String?
+        "The preview URL of the file."
+
     example default
         file = default
 
@@ -1553,8 +1556,7 @@ union LookupError
     not_folder
         "We were expecting a folder, but the given path refers to something that isn't a folder."
     restricted_content
-        "The file cannot be transferred because the content is restricted.  For example,
-        sometimes there are legal restrictions due to copyright claims."
+        "The file cannot be transferred because the content is restricted. For example, we might restrict a file due to legal requirements."
     unsupported_content_type
         "This operation is not supported for this content type."
     locked

team_log_generated.stone

@@ -406,6 +406,12 @@ union DownloadPolicyType
     allow
     disallow
 
+union DropboxPasswordsPolicy
+    "Policy for deciding whether team users can use Dropbox Passwords"
+    default
+    disabled
+    enabled
+
 union EmailIngestPolicy
     "Policy for deciding whether a team can use Email to Dropbox feature"
     disabled
@@ -5610,6 +5616,18 @@ struct DirectoryRestrictionsAddMembersDetails
 struct DirectoryRestrictionsRemoveMembersDetails
     "Removed members from directory restrictions list."
 
+struct DropboxPasswordsPolicyChangedDetails
+    "Changed Dropbox Passwords policy for team."
+
+    new_value DropboxPasswordsPolicy
+        "To."
+    previous_value DropboxPasswordsPolicy
+        "From."
+
+    example default
+        new_value = default
+        previous_value = default
+
 struct EmailIngestPolicyChangedDetails
     "Changed email to Dropbox policy for team."
 
@@ -7057,6 +7075,7 @@ union EventDetails
     device_approvals_remove_exception_details DeviceApprovalsRemoveExceptionDetails
     directory_restrictions_add_members_details DirectoryRestrictionsAddMembersDetails
     directory_restrictions_remove_members_details DirectoryRestrictionsRemoveMembersDetails
+    dropbox_passwords_policy_changed_details DropboxPasswordsPolicyChangedDetails
     email_ingest_policy_changed_details EmailIngestPolicyChangedDetails
     emm_add_exception_details EmmAddExceptionDetails
     emm_change_policy_details EmmChangePolicyDetails
@@ -9391,6 +9410,12 @@ struct DirectoryRestrictionsRemoveMembersType
     example default
         description = "(team_policies) Removed members from directory restrictions list"
 
+struct DropboxPasswordsPolicyChangedType
+    description String
+
+    example default
+        description = "(team_policies) Changed Dropbox Passwords policy for team"
+
 struct EmailIngestPolicyChangedType
     description String
 
@@ -10787,6 +10812,8 @@ union EventType
         "(team_policies) Added members to directory restrictions list"
     directory_restrictions_remove_members DirectoryRestrictionsRemoveMembersType
         "(team_policies) Removed members from directory restrictions list"
+    dropbox_passwords_policy_changed DropboxPasswordsPolicyChangedType
+        "(team_policies) Changed Dropbox Passwords policy for team"
     email_ingest_policy_changed EmailIngestPolicyChangedType
         "(team_policies) Changed email to Dropbox policy for team"
     emm_add_exception EmmAddExceptionType
@@ -11751,6 +11778,8 @@ union EventTypeArg
         "(team_policies) Added members to directory restrictions list"
     directory_restrictions_remove_members
         "(team_policies) Removed members from directory restrictions list"
+    dropbox_passwords_policy_changed
+        "(team_policies) Changed Dropbox Passwords policy for team"
     email_ingest_policy_changed
         "(team_policies) Changed email to Dropbox policy for team"
     emm_add_exception