Spec Update 04/26/2023 (#<TODO>) (#77)

Change Notes:

check_api_v2_types Namespace
- Update EchoArg DataType.STRUCT

files Namespace
- Update DeleteBatchArg DataType.STRUCT
- Update RelocationBatchArgBase DataType.STRUCT
- Update save_url DataType.ROUTE

team_log_generated Namespace
- Add RansomwareRestoreProcessCompletedDetails, RansomwareRestoreProcessStartedDetails, TeamEncryptionKeyCancelKeyDeletionDetails, TeamEncryptionKeyCreateKeyDetails, TeamEncryptionKeyDeleteKeyDetails, TeamEncryptionKeyDisableKeyDetails, TeamEncryptionKeyEnableKeyDetails, TeamEncryptionKeyRotateKeyDetails, TeamEncryptionKeyScheduleKeyDeletionDetails, FileAddFromAutomationDetails, ReplayFileDeleteDetails, BackupAdminInvitationSentDetails, BackupInvitationOpenedDetails, RansomwareAlertCreateReportDetails, RansomwareAlertCreateReportFailedDetails, ReplayFileSharedLinkCreatedDetails, ReplayFileSharedLinkModifiedDetails, ReplayProjectTeamAddDetails, ReplayProjectTeamDeleteDetails, RansomwareRestoreProcessCompletedType, RansomwareRestoreProcessStartedType, TeamEncryptionKeyCancelKeyDeletionType, TeamEncryptionKeyCreateKeyType, TeamEncryptionKeyDeleteKeyType, TeamEncryptionKeyDisableKeyType, TeamEncryptionKeyEnableKeyType, TeamEncryptionKeyRotateKeyType, TeamEncryptionKeyScheduleKeyDeletionType, FileAddFromAutomationType, ReplayFileDeleteType, BackupAdminInvitationSentType, BackupInvitationOpenedType, RansomwareAlertCreateReportType, RansomwareAlertCreateReportFailedType, ReplayFileSharedLinkCreatedType, ReplayFileSharedLinkModifiedType, ReplayProjectTeamAddType, ReplayProjectTeamDeleteType structs

team_member_space_limits Namespace
- Update member_space_limits/set_custom_quota(SetCustomQuotaArg, List DataType.ROUTE
- Update member_space_limits/remove_custom_quota(CustomQuotaUsersArg, List DataType.ROUTE
- Update member_space_limits/get_custom_quota(CustomQuotaUsersArg, List DataType.ROUTE
- Update member_space_limits/get_custom_quota(CustomQuotaUsersArg, List DataType.ROUTE

team_policies Namespace
- Add SharedFolderBlanketLinkRestrictionPolicy unions

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

Author: sderickson

auth.stone

@@ -78,7 +78,7 @@ union TokenFromOAuth1Error
     app_id_mismatch
         "The authorized app does not match the app associated with the supplied access token."
 
-route token/from_oauth1(TokenFromOAuth1Arg, TokenFromOAuth1Result, TokenFromOAuth1Error)
+route token/from_oauth1(TokenFromOAuth1Arg, TokenFromOAuth1Result, TokenFromOAuth1Error) deprecated
     "Creates an OAuth 2.0 access token from the supplied OAuth 1.0 access token."
     attrs
         auth = "app"

check_api_v2_types.stone

@@ -5,7 +5,7 @@ namespace check
 import common
 
 struct EchoArg
-    "EchoArg contains the arguments to be sent to the Dropbox servers."
+    "Contains the arguments to be sent to the Dropbox servers."
     query String(max_length=500) = ""
         "The string that you'd like to be echoed back to you."
 

file_requests.stone

@@ -135,7 +135,6 @@ route list:2(ListFileRequestsArg, ListFileRequestsV2Result, ListFileRequestsErro
 
     attrs
         allow_app_folder_app = true
-        is_preview = true
         scope = "file_requests.read"
 
 struct ListFileRequestsArg
@@ -172,7 +171,6 @@ route list/continue(ListFileRequestsContinueArg, ListFileRequestsV2Result, ListF
     :route:`list/continue`."
     attrs
         allow_app_folder_app = true
-        is_preview = true
         scope = "file_requests.read"
 
 struct ListFileRequestsContinueArg

file_tagging.stone

@@ -3,7 +3,7 @@ namespace files
 import common
 import async
 
-alias TagText = String(min_length=1, max_length=32, pattern="[A-Za-z0-9\_]+")
+alias TagText = String(min_length=1, max_length=32, pattern="[\\w]+")
 
 union Tag
     "Tag that can be added in multiple ways."

files.stone

@@ -1783,7 +1783,7 @@ union DeleteError
         "There are too many files in one request. Please retry with fewer files."
 
 struct DeleteBatchArg
-    entries List(DeleteArg)
+    entries List(DeleteArg, max_items=1000)
 
     example default
         entries = [delete]
@@ -1987,7 +1987,7 @@ struct RelocationResult extends FileOpsResult
         metadata = default
 
 struct RelocationBatchArgBase
-    entries List(RelocationPath, min_items=1)
+    entries List(RelocationPath, min_items=1, max_items=1000)
         "List of entries to be moved or copied. Each entry is :type:`RelocationPath`."
     autorename Boolean = false
         "If there's a conflict with any file, have the Dropbox server try to
@@ -2864,7 +2864,7 @@ union SaveUrlError
 route save_url(SaveUrlArg, SaveUrlResult, SaveUrlError)
     "Save the data from a specified URL into a file in user's Dropbox.
 
-    Note that the transfer from the URL must complete within 5 minutes, or the
+    Note that the transfer from the URL must complete within 15 minutes, or the
     operation will time out and the job will fail.
 
     If the given path already exists, the file will be renamed to avoid the

sharing_folders.stone

@@ -25,6 +25,12 @@ union AccessLevel
     traverse
         "The collaborator can only view the shared folder that they have
         access to."
+    no_access
+        "If there is a Righteous Link on the folder which grants access
+        and the user has visited such link, they are allowed to perform
+        certain action (i.e. add themselves to the folder) via the link
+        access even though the user themselves are not a member on the
+        shared folder yet."
 
 struct FolderPolicy
     "A set of policies governing membership and privileges for a shared
@@ -349,6 +355,9 @@ struct SharedFolderMetadataBase
         "The ID of the parent shared folder. This field is present only if the
         folder is contained within another shared folder."
 
+    path_display String?
+        "The full path of this shared folder. Absent for unmounted folders."
+
     path_lower String?
         "The lower-cased full path of this shared folder. Absent for unmounted folders."
 
@@ -425,6 +434,8 @@ union SharedFolderAccessError
     not_a_member
         "The user is not a member of the shared folder
         thus cannot access it."
+    invalid_member
+        "The user does not exist or their account is disabled."
     email_unverified
         "Never set."
     unmounted
@@ -666,9 +677,9 @@ struct ShareFolderArgBase
     member_policy MemberPolicy?
         "Who can be a member of this shared folder. Only applicable if the
         current user is on a team."
-    path files.WritePath
-        "The path to the folder to share. If it does not exist, then a new one
-        is created."
+    path files.WritePathOrId
+        "The path or the file id to the folder to share. If it does not exist,
+        then a new one is created."
     shared_link_policy SharedLinkPolicy?
         "The policy to apply to shared links created for content inside this
         shared folder.  The current user must be on a team to set this policy to

team.stone

@@ -159,7 +159,7 @@ struct TeamGetInfoResult
     num_provisioned_users UInt32
         "The number of accounts that have been invited or are already active members of the team."
 
-    num_used_licenses UInt32
+    num_used_licenses UInt32 = 0
         "The number of licenses used on the team."
 
     policies team_policies.TeamMemberPolicies