Change Notes

Account namespace:
	- Added set_profile_photo end point.

Auth namespace:
	- Added route_access_denied to AuthError.

Common namespace:
	- Added SecondaryEmail struct.

Contacts namespace:
	- Added scope route attribute to delete_manual_contacts end point.

Files namespace:
	- Added scope route attribute to the following end points:
		- get_metadata
		- list_folder/longpoll
		- list_folder
		- list_folder/continue
		- list_folder/get_latest_cursor
		- download
		- download_zip
		- export
		- upload_session/start
		- upload_session/append
		- upload_session/append:2
		- upload_session/finish
		- upload_session/finish_batch
		- upload_session/finish_batch/check
		- search
		- upload
		- create_folder
		- create_folder:2
		- create_folder_batch
		- create_folder_batch/check
		- delete
		- delete:2
		- delete_batch
		- delete_batch/check
		- permanently_delete
		- copy
		- copy:2
		- copy_batch
		- copy_batch:2
		- copy_batch/check
		-  copy_batch/check:2
		- move
		- move:2
		- move_batch
		- move_batch:2
		- move_batch/check:2
		- move_batch/check
		- get_thumbnail
		- get_thumbnail_batch
		- get_preview
		- list_revisions
		- restore
		- get_temporary_link
		- get_temporary_upload_link
		- copy_reference/get
		- copy_reference/save
		- save_url
		- save_url/check_job_status

	- Added new search:2 end point.
	- Added new search/continue:2 end point
	- Added new lock_file_batch end point
	- Added new unlock_file_batch end point
	- Added new get_file_lock_batch end point

	- Added New MetadataV2 union
	- Added new HighlightSpan struct
	- Added new FileLockMetadata struct
	- Added file_lock_info to FileMetadata struct
	- Added template_error to ListFolderError union
	- Added retry_error to ExportError union

File_properties namespace:
	- Added scope route attribute to to the following end points:
		- properties/add
		- properties/overwrite
		- properties/update
		- properties/remove
		- properties/search
		- templates/add_for_user
		- templates/add_for_team
		- templates/get_for_user
		- templates/get_for_team
		- templates/update_for_user
		- templates/update_for_team
		- templates/list_for_user
		- templates/list_for_team
		- templates/remove_for_user
		- templates/remove_for_team

File_requests namespace:
	- Added optional scope route attribute to to the following end points:
		- list:2
		- list/continue
		- list
		- get
		- create
		- update
		- count
		- delete
		- delete_all_closed
	- Updated docstrings for CreateFileRequestError

Team namespace:
	-  Added scope route attribute to to the following end points:
		-  legal_holds/release_policy
		-  members/secondary_emails/add
		-  members/secondary_emails
		- get_info
		- token/get_authenticated_admin
		- features/get_values
		- devices/list_member_devices
		- devices/list_members_devices
		- devices/revoke_device_session
		- devices/revoke_device_session_batch
		- team_folder/create
		- team_folder/rename
		- team_folder/list
		- team_folder/list/continue
		- team_folder/get_info
		- team_folder/activate
		- team_folder/archive
		- team_folder/archive/check
		- team_folder/permanently_delete
		- groups/list
		- groups/list/continue
		- groups/get_info
		- groups/create
		- groups/delete
		- groups/update
		- groups/members/add
		- groups/members/remove
		- groups/members/set_access_type
		- groups/members/list
		- groups/members/list/continue
		- linked_apps/list_member_linked_apps
		- linked_apps/list_members_linked_apps
		- linked_apps/revoke_linked_app
		- linked_apps/revoke_linked_app_batch
		- member_space_limits/set_custom_quota
		- member_space_limits/remove_custom_quota
		- member_space_limits/get_custom_quota
		- member_space_limits/excluded_users/add
		- member_space_limits/excluded_users/remove
		- member_space_limits/excluded_users/list
		- members/list
		- members/list/continue
		- members/get_info
		- members/add
		- members/add/job_status/get
		- members/set_admin_permissions
		- members/send_welcome_email
		- members/remove
		- members/remove/job_status/get
		- members/suspend
		- members/unsuspend
		- members/recover
		- members/move_former_member_files
		- namespaces/list
		- namespaces/list/continue
		- reports/get_storage
		- reports/get_activity
		- reports/get_membership

	- Added new legal_holds/release_policy end point.
	- Added new members/secondary_emails/add end point.
	- Added new members/secondary_emails/resend_verification_emails
	- Added new members/secondary_emails/delete end point
	- Added new members/set_profile_photo end point
	- Added new members/delete_profile_photo end point
	- Added secondary_emails to MemberProfile struct
	- Added invited_on to MemberProfile struct
	- Added retain_team_shares in MembersRemoveArg Struct
	- Added the following to MembersRemoveError union
		- cannot_retain_shares_when_data_wiped
		- cannot_retain_shares_when_no_account_kept
		- cannot_retain_shares_when_team_external_sharing_off
		- cannot_keep_account
		- cannot_keep_account_under_legal_hold
		- cannot_keep_account_required_to_sign_tos

	- Updated docstring for DateRange

Team_log namespace:
	- Add scope route attribute to the following end points:
		- get_events
	- Added unlink_device to QuickActionType union
	- Added enterprise_console to AccessMethodLogInfo
	- Added was_linked_apps_truncated, was_linked_devices_truncated
, was_linked_shared_folders_truncated to JoinTeamDetails struct
	- Added web_session, qr_code, apple_oauth to LoginMethod union
	- Added enterprise_admin to TrustedNonTeamMemberType union
	- Added team to TeamMemberLogInfo struct
	- Added is_shared_namespace to NamespaceRelativePathLogInfo struct
	- Added organization_team to ContextLogInfo union
	- Added legal_holds to EventCategory union
	- Added the following to EventDetails union:
		- folder_overview_description_changed_details
		- folder_overview_item_pinned_details
		- folder_overview_item_unpinned_details
		- legal_holds_activate_a_hold_details
		- legal_holds_add_members_details
		- legal_holds_change_hold_details_details
		- legal_holds_change_hold_name_details
		- legal_holds_export_a_hold_details
		- legal_holds_release_a_hold_details
		- legal_holds_remove_members_details
		- legal_holds_report_a_hold_details
		- member_delete_profile_photo_details
		- member_set_profile_photo_details
		- pending_secondary_email_added_details
		- secondary_email_deleted_details
		- secondary_email_verified_details
		- paper_published_link_change_permission_details
		- export_members_report_fail_details
		- file_transfers_file_add_details
		- file_transfers_transfer_delete_details
		- file_transfers_transfer_download_details
		- file_transfers_transfer_send_details
		- file_transfers_transfer_view_details
		- shared_content_restore_invitees_details
		- shared_content_restore_member_details
		- device_approvals_add_exception_details
		- device_approvals_remove_exception_details
		- file_locking_policy_changed_details
		- file_transfers_policy_changed_details
		- password_strength_requirements_change_policy_details
		- smarter_smart_sync_policy_changed_details
		- tfa_add_exception_details
		- tfa_remove_exception_details
		- watermarking_policy_changed_details
		- changed_enterprise_admin_role_details
		- changed_enterprise_connected_team_status_details
		- ended_enterprise_admin_session_details
		- ended_enterprise_admin_session_deprecated_details
		- started_enterprise_admin_session_details
	- Added the following to EventType union:
		- folder_overview_description_changed
		- folder_overview_item_pinned
		- folder_overview_item_unpinned
		- legal_holds_activate_a_hold
		- legal_holds_add_members
		- legal_holds_change_hold_details
		- legal_holds_change_hold_name
		- legal_holds_export_a_hold
		- legal_holds_release_a_hold
		- legal_holds_remove_members
		- legal_holds_report_a_hold
		- member_delete_profile_photo
		- member_set_profile_photo
		- pending_secondary_email_added
		- secondary_email_deleted
		- secondary_email_verified
		- paper_published_link_change_permission
		- export_members_report_fail
		- file_transfers_file_add
		- file_transfers_transfer_delete
		- file_transfers_transfer_download
		- file_transfers_transfer_send
		- file_transfers_transfer_view
		- shared_content_restore_invitees
		- shared_content_restore_member
		- device_approvals_add_exception
		- device_approvals_remove_exception
		- file_locking_policy_changed
		- file_transfers_policy_changed
		- password_strength_requirements_change_policy
		- smarter_smart_sync_policy_changed
		- tfa_add_exception
		- tfa_remove_exception
		- watermarking_policy_changed
		- changed_enterprise_admin_role
		- changed_enterprise_connected_team_status
		- ended_enterprise_admin_session
		- ended_enterprise_admin_session_deprecated
		- started_enterprise_admin_session

Team_policies namespace:
	- Added disabled in TwoStepVerificationState union
	- Added new unions PasswordControlMode, SmarterSmartSyncPolicyState
, FileLockingPolicyState

Paper namespace:
	- Updated doctoring for the namespace
	- Updated doctoring for PaperApiBaseError
	- Added PaperFolderCreateArg, PaperFolderCreateResult structs
	- Added new PaperFolderCreateError union
	- Updated docstring for following end points:
		- docs/folder_users/list
		- docs/folder_users/list/continue
		- docs/sharing_policy/get
		- docs/sharing_policy/set
		- docs/archive
		- docs/permanently_delete
		- docs/download
		- docs/get_folder_info
		- docs/users/add
		- docs/users/remove
		- docs/users/list
		- docs/users/list/continue
		- docs/list
		- docs/list/continue
		- docs/create
		- docs/update
		- folders/create
	-  Added scope route attribute to the following end points:
		- docs/folder_users/list
		- docs/folder_users/list/continue
		- docs/sharing_policy/get
		- docs/sharing_policy/set
		- docs/archive
		- docs/permanently_delete
		- docs/download
		- docs/get_folder_info
		- docs/users/add
		- docs/users/remove
		- docs/users/list
		- docs/users/list/continue
		- docs/list
		- docs/list/continue
		- docs/create
		- docs/update

Sharing namespace:
	 Add scope route attribute to the following end points:
		- get_shared_link_metadata
		- list_shared_links
		- modify_shared_link_settings
		- create_shared_link_with_settings
		- revoke_shared_link
		- get_shared_link_file
		- add_file_member
		- update_file_member
		- get_file_metadata
		- get_file_metadata/batch
		- list_file_members
		- list_file_members/batch
		- list_file_members/continue
		- list_received_files
		- list_received_files/continue
		- remove_file_member
		- remove_file_member_2
		- relinquish_file_membership
		- unsharp_file
		- list_folders
		- list_folders/continue
		- list_mountable_folders
		- list_mountable_folders/continue
		- get_folder_metadata
		- list_folder_members
		- list_folder_members/continue
		- share_folder
		- check_share_job_status
		- check_job_status
		- unsharp_folder
		- transfer_folder
		- update_folder_policy
		- add_folder_member
		- remove_folder_member
		- check_remove_member_job_status
		- update_folder_member
		- mount_folder
		- unmount_folder
		- relinquish_folder_membership
		- set_access_inheritance

	- Add parent_folder_name to SharedFolderMetadataBase

	Users namespace:
		- Added scope route attribute to the following end points:
			- get_account
			- get_current_account
			- get_space_usage
			- get_account_batch
			-
		- Added user_within_team_space_used_cached to TeamSpaceAllocation struct
		- Added new features/get_values end point

Author: Milan Ghatak

account.stone

@@ -0,0 +1,47 @@
+namespace account
+
+import common
+
+#
+# Route set_profile_photo
+#
+
+union PhotoSourceArg
+    base64_data String
+        "Image data in base64-encoded bytes."
+
+    example default
+        base64_data = "SW1hZ2UgZGF0YSBpbiBiYXNlNjQtZW5jb2RlZCBieXRlcy4gTm90IGEgdmFsaWQgZXhhbXBsZS4="
+
+
+struct SetProfilePhotoArg
+    photo PhotoSourceArg
+        "Image to set as the user's new profile photo."
+
+    example default
+        photo = default
+
+
+struct SetProfilePhotoResult
+    profile_photo_url String
+        "URL for the photo representing the user, if one is set."
+
+    example default
+        profile_photo_url = "https://dl-web.dropbox.com/account_photo/get/dbaphid%3AAAHWGmIXV3sUuOmBfTz0wPsiqHUpBWvv3ZA?vers=1556069330102&size=128x128"
+
+
+union SetProfilePhotoError
+    file_type_error
+        "File cannot be set as profile photo."
+    file_size_error
+        "File cannot exceed 10 MB."
+    dimension_error
+        "Image must be larger than 128 x 128."
+    thumbnail_error
+        "Image could not be thumbnailed."
+    transient_error
+        "Temporary infrastructure failure, please retry."
+
+route set_profile_photo(SetProfilePhotoArg, SetProfilePhotoResult, SetProfilePhotoError)
+    "Sets a user's profile photo."
+

auth.stone

@@ -21,12 +21,13 @@ union AuthError
         "The access token has expired."
     missing_scope TokenScopeError
         "The access token does not have the required scope to access the route."
+    route_access_denied
+        "The route is not available to public."
 
 route token/revoke(Void, Void, Void)
     "Disables the access token used to authenticate the call."
 
     attrs
-        owner = "api-platform"
         allow_app_folder_app = true
 
 union RateLimitReason
@@ -79,7 +80,6 @@ route token/from_oauth1(TokenFromOAuth1Arg, TokenFromOAuth1Result, TokenFromOAut
     "Creates an OAuth 2.0 access token from the supplied OAuth 1.0 access token."
     attrs
         auth = "app"
-        owner = "api-platform"
         allow_app_folder_app = true
 
 union AccessError

contacts.stone

@@ -8,8 +8,7 @@ route delete_manual_contacts(Void, Void, Void)
     New contacts will be added when you share."
 
     attrs
-        cluster = "meta-peeps"
-        owner = "teams-and-groups"
+        scope = "contacts.write"
 
 struct DeleteManualContactsArg
     email_addresses List(common.EmailAddress)
@@ -27,6 +26,3 @@ union DeleteManualContactsError
 route delete_manual_contacts_batch(DeleteManualContactsArg, Void, DeleteManualContactsError)
     "Removes manually added contacts from the given list."
 
-    attrs
-        cluster = "meta-peeps"
-        owner = "teams-and-groups"

file_properties.stone

@@ -178,8 +178,7 @@ route properties/add(AddPropertiesArg, Void, AddPropertiesError)
     :route:`templates/add_for_team` to create new templates."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.write"
 
 struct OverwritePropertyGroupArg
     path PathOrId
@@ -199,8 +198,7 @@ route properties/overwrite(OverwritePropertyGroupArg, Void, InvalidPropertyGroup
     delete fields that are explicitly marked for deletion."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.write"
 
 struct PropertyGroupUpdate
     template_id TemplateId
@@ -237,8 +235,7 @@ route properties/update(UpdatePropertiesArg, Void, UpdatePropertiesError)
     will delete any fields that are omitted from a property group."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.write"
 
 struct RemovePropertiesArg
     path PathOrId
@@ -263,8 +260,7 @@ route properties/remove(RemovePropertiesArg, Void, RemovePropertiesError)
     :route:`templates/remove_for_user` or :route:`templates/remove_for_team`."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.write"
 
 #
 # Property Group Template Routes
@@ -300,8 +296,7 @@ route templates/add_for_user(AddTemplateArg, AddTemplateResult, ModifyTemplateEr
     endpoint can't be called on a team member or admin's behalf."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.write"
 
 route templates/add_for_team(AddTemplateArg, AddTemplateResult, ModifyTemplateError)
     "Add a template associated with a team. See :route:`properties/add` to add properties to a file or folder.
@@ -310,8 +305,7 @@ route templates/add_for_team(AddTemplateArg, AddTemplateResult, ModifyTemplateEr
 
     attrs
         auth="team"
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.team_metadata.write"
 
 struct GetTemplateArg
     template_id TemplateId
@@ -332,16 +326,14 @@ route templates/get_for_user(GetTemplateArg, GetTemplateResult, TemplateError)
     "Get the schema for a specified template. This endpoint can't be called on a team member or admin's behalf."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.read"
 
 route templates/get_for_team(GetTemplateArg, GetTemplateResult, TemplateError)
     "Get the schema for a specified template."
 
     attrs
         auth="team"
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.team_metadata.write"
 
 struct UpdateTemplateArg
     template_id TemplateId
@@ -377,17 +369,15 @@ route templates/update_for_user(UpdateTemplateArg, UpdateTemplateResult, ModifyT
     be called on a team member or admin's behalf."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.write"
 
 route templates/update_for_team(UpdateTemplateArg, UpdateTemplateResult, ModifyTemplateError)
     "Update a template associated with a team. This route can update the template name,
     the template description and add optional properties to templates."
 
     attrs
         auth="team"
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.team_metadata.write"
 
 struct ListTemplateResult
     template_ids List(TemplateId)
@@ -403,17 +393,15 @@ route templates/list_for_user(Void, ListTemplateResult, TemplateError)
     called on a team member or admin's behalf."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.read"
 
 route templates/list_for_team(Void, ListTemplateResult, TemplateError)
     "Get the template identifiers for a team. To get the schema of
     each template use :route:`templates/get_for_team`."
 
     attrs
         auth="team"
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.team_metadata.write"
 
 struct RemoveTemplateArg
     template_id TemplateId
@@ -429,8 +417,7 @@ route templates/remove_for_user(RemoveTemplateArg, Void, TemplateError)
     cannot be undone."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.write"
 
 route templates/remove_for_team(RemoveTemplateArg, Void, TemplateError)
     "Permanently removes the specified template created from :route:`templates/add_for_user`.
@@ -439,8 +426,7 @@ route templates/remove_for_team(RemoveTemplateArg, Void, TemplateError)
 
     attrs
         auth="team"
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.team_metadata.write"
 
 union TemplateOwnerType
     user
@@ -538,8 +524,7 @@ route properties/search(PropertiesSearchArg, PropertiesSearchResult, PropertiesS
     "Search across property templates for particular property field values."
 
     attrs
-        api_group="properties"
-        owner = "api-platform"
+        scope = "files.metadata.read"
 
 struct PropertiesSearchContinueArg
     cursor PropertiesSearchCursor
@@ -558,6 +543,3 @@ route properties/search/continue (PropertiesSearchContinueArg, PropertiesSearchR
     "Once a cursor has been retrieved from :route:`properties/search`, use this to paginate through all
     search results."
 
-    attrs
-        api_group="properties"
-        owner = "api-platform"

file_requests.stone

@@ -131,9 +131,9 @@ route list:2(ListFileRequestsArg, ListFileRequestsV2Result, ListFileRequestsErro
     the app folder."
 
     attrs
-        owner = "sharing"
         allow_app_folder_app = true
         is_preview = true
+        scope = "file_requests.read"
 
 struct ListFileRequestsArg
     "Arguments for :route:`list:2`."
@@ -168,9 +168,9 @@ route list/continue(ListFileRequestsContinueArg, ListFileRequestsV2Result, ListF
     file requests. The cursor must come from a previous call to :route:`list:2` or
     :route:`list/continue`."
     attrs
-        owner = "sharing"
         allow_app_folder_app = true
         is_preview = true
+        scope = "file_requests.read"
 
 struct ListFileRequestsContinueArg
     cursor String
@@ -192,8 +192,8 @@ route list(Void, ListFileRequestsResult, ListFileRequestsError)
     the app folder."
 
     attrs
-        owner = "sharing"
         allow_app_folder_app = true
+        scope = "file_requests.read"
 
 struct ListFileRequestsResult
     "Result for :route:`list`."
@@ -217,8 +217,8 @@ route get(GetFileRequestArgs, FileRequest, GetFileRequestError)
     "Returns the specified file request."
 
     attrs
-        owner = "sharing"
         allow_app_folder_app = true
+        scope = "file_requests.read"
 
 struct GetFileRequestArgs
     "Arguments for :route:`get`."
@@ -241,8 +241,8 @@ route create(CreateFileRequestArgs, FileRequest, CreateFileRequestError)
     "Creates a file request for this user."
 
     attrs
-        owner = "sharing"
         allow_app_folder_app = true
+        scope = "file_requests.write"
 
 struct CreateFileRequestArgs
     "Arguments for :route:`create`."
@@ -273,7 +273,7 @@ union CreateFileRequestError extends FileRequestError
         "File requests are not available on the specified folder."
     rate_limit
         "The user has reached the rate limit for creating file requests. The
-        limit is currently 100 file requests per day."
+        limit is currently 4000 file requests total."
 
 #
 # Updating existing file requests
@@ -283,8 +283,8 @@ route update(UpdateFileRequestArgs, FileRequest, UpdateFileRequestError)
     "Update a file request."
 
     attrs
-        owner = "sharing"
         allow_app_folder_app = true
+        scope = "file_requests.write"
 
 struct UpdateFileRequestArgs
     "Arguments for :route:`update`."
@@ -330,9 +330,8 @@ route count(Void, CountFileRequestsResult, CountFileRequestsError)
     closed file requests."
 
     attrs
-        owner = "sharing"
         allow_app_folder_app = true
-
+        scope = "file_requests.read"
 
 struct CountFileRequestsResult
     "Result for :route:`count`."
@@ -354,8 +353,8 @@ route delete(DeleteFileRequestArgs, DeleteFileRequestsResult, DeleteFileRequestE
     "Delete a batch of closed file requests."
 
     attrs
-        owner = "sharing"
         allow_app_folder_app = true
+        scope = "file_requests.write"
 
 struct DeleteFileRequestArgs
     "Arguments for :route:`delete`."
@@ -389,8 +388,8 @@ route delete_all_closed(Void, DeleteAllClosedFileRequestsResult, DeleteAllClosed
     "Delete all closed file requests owned by this user."
 
     attrs
-        owner = "sharing"
         allow_app_folder_app = true
+        scope = "file_requests.write"
 
 struct DeleteAllClosedFileRequestsResult
     "Result for :route:`delete_all_closed`."