Spec Update 01/22/2021 (#28)

Change Notes:

Files Namespace:
- Update Comments
- Update Legacy Scopes

Shared Links Namespace:
- Update Comments
- Update Legacy Scopes

Sharing Files Namespace:
- Update Comments
- Update Legacy Scopes

Team Namespace:
- Update Comments
- Update Legacy Scopes

Team Devices Namespace:
- Update Comments
- Update Legacy Scopes

Team Linked Apps Namespace:
- Update Comments
- Update Legacy Scopes

Author: rogebrd

files.stone

@@ -2748,6 +2748,7 @@ route alpha/get_metadata (AlphaGetMetadataArg, Metadata, AlphaGetMetadataError)
     attrs
         is_preview=true
         allow_app_folder_app = true
+        scope = "files.metadata.read"
 
 struct AlphaGetMetadataArg extends GetMetadataArg
 
@@ -2785,6 +2786,7 @@ route alpha/upload (CommitInfoWithProperties, FileMetadata, UploadErrorWithPrope
         style="upload"
         is_preview=true
         allow_app_folder_app = true
+        scope = "files.content.write"
 
 struct CommitInfoWithProperties extends CommitInfo
     example default
@@ -2800,11 +2802,29 @@ union UploadErrorWithProperties extends UploadError
 #
 
 route properties/add(file_properties.AddPropertiesArg, Void, file_properties.AddPropertiesError) deprecated
+    attrs
+        scope = "files.metadata.write"
+
 route properties/overwrite(file_properties.OverwritePropertyGroupArg, Void, file_properties.InvalidPropertyGroupError) deprecated
+    attrs
+        scope = "files.metadata.write"
+
 route properties/update(file_properties.UpdatePropertiesArg, Void, file_properties.UpdatePropertiesError) deprecated
+    attrs
+        scope = "files.metadata.write"
+
 route properties/remove(file_properties.RemovePropertiesArg, Void, file_properties.RemovePropertiesError) deprecated
+    attrs
+        scope = "files.metadata.write"
+
 route properties/template/get(file_properties.GetTemplateArg, file_properties.GetTemplateResult, file_properties.TemplateError) deprecated
+    attrs
+        scope = "files.metadata.read"
+
 route properties/template/list(Void, file_properties.ListTemplateResult, file_properties.TemplateError) deprecated
+    attrs
+        scope = "files.metadata.read"
+
 #
 # Team selective sync additions
 #

shared_links.stone

@@ -570,6 +570,7 @@ route get_shared_links(GetSharedLinksArg, GetSharedLinksResult, GetSharedLinksEr
 
     attrs
         allow_app_folder_app = true
+        scope = "sharing.read"
 
 union_closed PendingUploadMode
     "Flag to indicate pending upload default (for linking to not-yet-existing paths)."
@@ -615,3 +616,4 @@ route create_shared_link(CreateSharedLinkArg, PathLinkMetadata, CreateSharedLink
     attrs
         allow_app_folder_app = true
         select_admin_mode = "team_admin"
+        scope = "sharing.write"

sharing_files.stone

@@ -289,6 +289,9 @@ struct AddFileMemberArgs
 route change_file_member_access(ChangeFileMemberAccessArgs, FileMemberActionResult, FileMemberActionError) deprecated by update_file_member
     "Identical to update_file_member but with less information returned."
 
+    attrs
+        scope = "sharing.write"
+
 struct ChangeFileMemberAccessArgs
     "Arguments for :route:`change_file_member_access`."
 

team.stone

@@ -329,18 +329,22 @@ route properties/template/add(file_properties.AddTemplateArg, file_properties.Ad
 
     attrs
         auth = "team"
+        scope = "files.team_metadata.write"
 
 route properties/template/update(file_properties.UpdateTemplateArg, file_properties.UpdateTemplateResult, file_properties.ModifyTemplateError) deprecated
     "Permission : Team member file access."
     attrs
         auth = "team"
+        scope = "files.team_metadata.write"
 
 route properties/template/get(file_properties.GetTemplateArg, file_properties.GetTemplateResult, file_properties.TemplateError) deprecated
-    "Permission : Team member file access."
+    "Permission : Team member file access. The scope for the route is files.team_metadata.write."
     attrs
         auth = "team"
+        scope = "files.team_metadata.write"
 
 route properties/template/list(Void, file_properties.ListTemplateResult, file_properties.TemplateError) deprecated
-    "Permission : Team member file access."
+    "Permission : Team member file access. The scope for the route is files.team_metadata.write."
     attrs
         auth = "team"
+        scope = "files.team_metadata.write"

team_devices.stone

@@ -356,3 +356,4 @@ route devices/list_team_devices(ListTeamDevicesArg, ListTeamDevicesResult, ListT
 
     attrs
         auth = "team"
+        scope = "sessions.list"

team_linked_apps.stone

@@ -215,3 +215,4 @@ route linked_apps/list_team_linked_apps(ListTeamAppsArg, ListTeamAppsResult, Lis
 
     attrs
         auth = "team"
+        scope = "sessions.list"