Spec Update 08/31/2022

file_tagging.stone

@@ -34,11 +34,11 @@ struct AddTagArg
         "Path to the item to be tagged."
 
     tag_text TagText
-        "The value of the tag to add."
+        "The value of the tag to add. Will be automatically converted to lowercase letters."
 
     example default
         path = "/Prime_Numbers.txt"
-        tag_text = "MyTag"
+        tag_text = "my_tag"
 
 union AddTagError extends BaseTagError
     too_many_tags
@@ -62,11 +62,11 @@ struct RemoveTagArg
         "Path to the item to tag."
 
     tag_text TagText
-        "The tag to remove."
+        "The tag to remove. Will be automatically converted to lowercase letters."
 
     example default
         path = "/Prime_Numbers.txt"
-        tag_text = "MyTag"
+        tag_text = "my_tag"
 
 union RemoveTagError extends BaseTagError
     tag_not_present

openid_openid.stone

@@ -0,0 +1,14 @@
+# @generated by protoc-gen-stone. DO NOT EDIT.
+# source: configs/proto/dropbox/proto/openid/openid.proto
+namespace openid
+
+route userinfo (UserInfoArgs, UserInfoResult, UserInfoError)
+    "This route is used for refreshing the info that is found in the id_token during the OIDC flow.
+    This route doesn't require any arguments and will use the scopes approved for the given access token."
+
+    attrs
+        allow_app_folder_app = true
+        auth = "user"
+        is_preview = true
+        scope = "openid"
+

openid_openid_types.stone

@@ -14,15 +14,23 @@ struct UserInfoError
         union
             auth_error AuthError = invalid_token
     error_message String = ""
+        "Brief explanation of the error."
 
 struct UserInfoArgs
     "This struct is empty. The comment here is intentionally emitted to avoid indentation issues with Stone."
 
 struct UserInfoResult
     family_name String?
+        "Last name of user."
     given_name String?
+        "First name of user."
     email String?
+        "Email address of user."
     email_verified Boolean?
+        "If user is email verified."
     iss String = ""
+        "Issuer of token (in this case Dropbox)."
     sub String = ""
+        "An identifier for the user. This is the Dropbox account_id, a string
+        value such as dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc."
 

sharing_files.stone

@@ -207,7 +207,9 @@ struct FileMemberActionResult
 
 union_closed FileMemberActionIndividualResult
     success AccessLevel?
-        "Member was successfully removed from this file. If AccessLevel is given,
+        "Part of the response for both add_file_member and remove_file_member_v1 (deprecated).
+        For add_file_member, indicates giving access was successful and at what AccessLevel.
+        For remove_file_member_v1, indicates member was successfully removed from the file. If AccessLevel is given,
         the member still has access via a parent shared folder."
     member_error FileMemberActionError
         "User was not able to perform this action."

team_log_generated.stone

@@ -940,6 +940,7 @@ struct TeamLogInfo
 union TeamMembershipType
     free
     full
+    guest
 
 union TeamMergeRequestAcceptedExtraDetails
     "Team merge request acceptance details"
@@ -5508,7 +5509,7 @@ struct AccountCaptureChangePolicyDetails
         previous_value = disabled
 
 struct AdminEmailRemindersChangedDetails
-    "Changed admin email reminder policy for team requests to join."
+    "Changed admin reminder settings for requests to join the team."
 
     new_value AdminEmailRemindersPolicy
         "To."
@@ -5777,6 +5778,18 @@ struct FileLockingPolicyChangedDetails
         new_value = disabled
         previous_value = disabled
 
+struct FileProviderMigrationPolicyChangedDetails
+    "Changed File Provider Migration policy for team."
+
+    new_value team_policies.FileProviderMigrationPolicyState
+        "To."
+    previous_value team_policies.FileProviderMigrationPolicyState
+        "From."
+
+    example default
+        new_value = default
+        previous_value = default
+
 struct FileRequestsChangePolicyDetails
     "Enabled/disabled file requests."
 
@@ -7158,6 +7171,7 @@ union EventDetails
     external_drive_backup_policy_changed_details ExternalDriveBackupPolicyChangedDetails
     file_comments_change_policy_details FileCommentsChangePolicyDetails
     file_locking_policy_changed_details FileLockingPolicyChangedDetails
+    file_provider_migration_policy_changed_details FileProviderMigrationPolicyChangedDetails
     file_requests_change_policy_details FileRequestsChangePolicyDetails
     file_requests_emails_enabled_details FileRequestsEmailsEnabledDetails
     file_requests_emails_restricted_to_team_only_details FileRequestsEmailsRestrictedToTeamOnlyDetails
@@ -9392,7 +9406,7 @@ struct AdminEmailRemindersChangedType
     description String
 
     example default
-        description = "(team_policies) Changed admin email reminder policy for team requests to join"
+        description = "(team_policies) Changed admin reminder settings for requests to join the team"
 
 struct AllowDownloadDisabledType
     description String
@@ -9556,6 +9570,12 @@ struct FileLockingPolicyChangedType
     example default
         description = "(team_policies) Changed file locking policy for team"
 
+struct FileProviderMigrationPolicyChangedType
+    description String
+
+    example default
+        description = "(team_policies) Changed File Provider Migration policy for team"
+
 struct FileRequestsChangePolicyType
     description String
 
@@ -10873,7 +10893,7 @@ union EventType
     account_capture_change_policy AccountCaptureChangePolicyType
         "(team_policies) Changed account capture setting on team domain"
     admin_email_reminders_changed AdminEmailRemindersChangedType
-        "(team_policies) Changed admin email reminder policy for team requests to join"
+        "(team_policies) Changed admin reminder settings for requests to join the team"
     allow_download_disabled AllowDownloadDisabledType
         "(team_policies) Disabled downloads (deprecated, no longer logged)"
     allow_download_enabled AllowDownloadEnabledType
@@ -10928,6 +10948,8 @@ union EventType
         "(team_policies) Enabled/disabled commenting on team files"
     file_locking_policy_changed FileLockingPolicyChangedType
         "(team_policies) Changed file locking policy for team"
+    file_provider_migration_policy_changed FileProviderMigrationPolicyChangedType
+        "(team_policies) Changed File Provider Migration policy for team"
     file_requests_change_policy FileRequestsChangePolicyType
         "(team_policies) Enabled/disabled file requests"
     file_requests_emails_enabled FileRequestsEmailsEnabledType
@@ -11845,7 +11867,7 @@ union EventTypeArg
     account_capture_change_policy
         "(team_policies) Changed account capture setting on team domain"
     admin_email_reminders_changed
-        "(team_policies) Changed admin email reminder policy for team requests to join"
+        "(team_policies) Changed admin reminder settings for requests to join the team"
     allow_download_disabled
         "(team_policies) Disabled downloads (deprecated, no longer logged)"
     allow_download_enabled
@@ -11900,6 +11922,8 @@ union EventTypeArg
         "(team_policies) Enabled/disabled commenting on team files"
     file_locking_policy_changed
         "(team_policies) Changed file locking policy for team"
+    file_provider_migration_policy_changed
+        "(team_policies) Changed File Provider Migration policy for team"
     file_requests_change_policy
         "(team_policies) Enabled/disabled file requests"
     file_requests_emails_enabled