Spec Update 02/02/2022 (#<TODO>) (#65)

Change Notes:

files Namespace
- Add MoveIntoFamilyError unions
- Add payload_too_large and cant_move_into_family errors

sharing_files Namespace
- doc update

team_log_generated Namespace
- Add DataResidencyMigrationRequestSuccessfulDetails, DataResidencyMigrationRequestUnsuccessfulDetails, DataResidencyMigrationRequestSuccessfulType, DataResidencyMigrationRequestUnsuccessfulType structs

Co-authored-by: Scott Erickson <serickson@dropbox.com>

Author: sderickson

files.stone

@@ -778,6 +778,8 @@ union UploadError
         "Unable to save the uploaded contents to a file."
     properties_error file_properties.InvalidPropertyGroupError
         "The supplied property group is invalid. The file has uploaded without property groups."
+    payload_too_large
+        "The request payload must be at most 150 MB."
 
 struct UploadSessionOffsetError
     correct_offset UInt64
@@ -788,6 +790,8 @@ union UploadSessionStartError
         "Uploading data not allowed when starting concurrent upload session."
     concurrent_session_close_not_allowed
         "Can not start a closed concurrent upload session."
+    payload_too_large
+        "The request payload must be at most 150 MB."
 
 union UploadSessionLookupError
     not_found
@@ -810,6 +814,8 @@ union UploadSessionLookupError
         "For concurrent upload sessions, offset needs to be multiple of 4194304 bytes."
     concurrent_session_invalid_data_size
         "For concurrent upload sessions, only chunks with size multiple of 4194304 bytes can be uploaded."
+    payload_too_large
+        "The request payload must be at most 150 MB."
 
 union UploadSessionFinishError
     lookup_failed UploadSessionLookupError
@@ -832,6 +838,8 @@ union UploadSessionFinishError
         "Concurrent upload sessions need to be closed before finishing."
     concurrent_session_missing_data
         "Not all pieces of data were uploaded before trying to finish the session."
+    payload_too_large
+        "The request payload must be at most 150 MB."
 
 # Req/Resp
 
@@ -1884,11 +1892,17 @@ union RelocationError
         "Can't move the shared folder to the given destination."
     cant_move_into_vault MoveIntoVaultError
         "Some content cannot be moved into Vault under certain circumstances, see detailed error."
+    cant_move_into_family MoveIntoFamilyError
+        "Some content cannot be moved into the Family Room folder under certain circumstances, see detailed error."
 
 union MoveIntoVaultError
     is_shared_folder
         "Moving shared folder into Vault is not allowed."
 
+union MoveIntoFamilyError
+    is_shared_folder
+        "Moving shared folder into Family Room folder is not allowed."
+
 struct RelocationResult extends FileOpsResult
     metadata Metadata
         "Metadata of the relocated object."

sharing_files.stone

@@ -268,7 +268,7 @@ struct AddFileMemberArgs
         "Message to send to added members in their invitation."
 
     quiet Boolean = false
-        "Whether added members should be notified via device notifications of
+        "Whether added members should be notified via email and device notifications of
         their invitation."
 
     access_level AccessLevel = viewer

team_log_generated.stone

@@ -6300,6 +6300,12 @@ struct WebSessionsChangeIdleLengthPolicyDetails
         new_value = default
         previous_value = default
 
+struct DataResidencyMigrationRequestSuccessfulDetails
+    "Requested data residency migration for team data."
+
+struct DataResidencyMigrationRequestUnsuccessfulDetails
+    "Request for data residency migration for team data has failed."
+
 struct TeamMergeFromDetails
     "Merged another team into this team."
 
@@ -7116,6 +7122,8 @@ union EventDetails
     web_sessions_change_active_session_limit_details WebSessionsChangeActiveSessionLimitDetails
     web_sessions_change_fixed_length_policy_details WebSessionsChangeFixedLengthPolicyDetails
     web_sessions_change_idle_length_policy_details WebSessionsChangeIdleLengthPolicyDetails
+    data_residency_migration_request_successful_details DataResidencyMigrationRequestSuccessfulDetails
+    data_residency_migration_request_unsuccessful_details DataResidencyMigrationRequestUnsuccessfulDetails
     team_merge_from_details TeamMergeFromDetails
     team_merge_to_details TeamMergeToDetails
     team_profile_add_background_details TeamProfileAddBackgroundDetails
@@ -9773,6 +9781,18 @@ struct WebSessionsChangeIdleLengthPolicyType
     example default
         description = "(team_policies) Changed how long team members can be idle while signed in to Dropbox.com"
 
+struct DataResidencyMigrationRequestSuccessfulType
+    description String
+
+    example default
+        description = "(team_profile) Requested data residency migration for team data"
+
+struct DataResidencyMigrationRequestUnsuccessfulType
+    description String
+
+    example default
+        description = "(team_profile) Request for data residency migration for team data has failed"
+
 struct TeamMergeFromType
     description String
 
@@ -10897,6 +10917,10 @@ union EventType
         "(team_policies) Changed how long members can stay signed in to Dropbox.com"
     web_sessions_change_idle_length_policy WebSessionsChangeIdleLengthPolicyType
         "(team_policies) Changed how long team members can be idle while signed in to Dropbox.com"
+    data_residency_migration_request_successful DataResidencyMigrationRequestSuccessfulType
+        "(team_profile) Requested data residency migration for team data"
+    data_residency_migration_request_unsuccessful DataResidencyMigrationRequestUnsuccessfulType
+        "(team_profile) Request for data residency migration for team data has failed"
     team_merge_from TeamMergeFromType
         "(team_profile) Merged another team into this team"
     team_merge_to TeamMergeToType
@@ -11857,6 +11881,10 @@ union EventTypeArg
         "(team_policies) Changed how long members can stay signed in to Dropbox.com"
     web_sessions_change_idle_length_policy
         "(team_policies) Changed how long team members can be idle while signed in to Dropbox.com"
+    data_residency_migration_request_successful
+        "(team_profile) Requested data residency migration for team data"
+    data_residency_migration_request_unsuccessful
+        "(team_profile) Request for data residency migration for team data has failed"
     team_merge_from
         "(team_profile) Merged another team into this team"
     team_merge_to