Update public spec.

- Authentication
  - Add token/revoke endpoint.
- Account
  - Add disabled field to Account.
- Files
  - Add include_deleted and include_has_explicit_shared_members parameter to get_metadata and list_folder endpoint.
  - Add close parameter to upload_session/start endpoint to support explicitly close an upload session.
  - Add upload_session/append_v2 endpoint which provides explicit session close support. upload_session/append endpoint is now deprecated.
  - Add copy_reference endpoint.
  - Add get_temporary_link endpoint.
- Shared links
  - Add remove_expiration parameter to modify_shared_link_settings endpoint.
- Shared folders
  - Add leave_a_copy to FolderAction.
  - Add time_invited to SharedFolderMetadata.
  - Return is_osx_package or inside_osx_package error when user attempts to share an OS X package or folder inside OS X package.
- Business endpoints
  - member_count is now optional in GroupSummary.
  - devices/list_team_devices endpoint is now deprecated by devices/list_member_devices.
  - linked_apps/list_team_linked_apps is now deprecated by linked_apps/list_members_linked_apps endpoint.
  - Add return_members parameter to groups/members/set_access_type endpoint.

Author: Qiming Yuan

auth.babel

@@ -10,3 +10,5 @@ union AuthError
     other*
         "An unspecified error."
 
+route token/revoke(Void, Void, Void)
+    "Disables the access token used to authenticate the call."

files.babel

@@ -3,6 +3,7 @@ namespace files
 
 import common
 import users
+import properties
 
 alias Id = String(min_length=1)
 alias Path = String(pattern="/.*")
@@ -176,6 +177,16 @@ struct FileMetadata extends Metadata
         "Additional information if the file is a photo or video."
     sharing_info FileSharingInfo?
         "Set if this file is contained in a shared folder."
+    property_groups List(properties.PropertyGroup)?
+        "Additional information if the file has custom properties with the
+        property template specified."
+    has_explicit_shared_members Boolean?
+        "This flag will only be present if include_has_explicit_shared_members
+         is true in :route:`list_folder` or :route:`get_metadata`. If this
+         flag is present, it will be true if this file has any explicit shared
+         members. This is different from sharing_info in that this could be true
+         in the case where a file has explicit members but is not contained within
+         a shared folder."
 
     example default
         id = "id:a4ayc_80_OEAAAAAAAAAXw"
@@ -187,6 +198,8 @@ struct FileMetadata extends Metadata
         server_modified = "2015-05-12T15:50:38Z"
         rev = "a1c10ce0dd78"
         size = 7212
+        property_groups = [default]
+        has_explicit_shared_members = false
 
 struct FolderMetadata extends Metadata
     id Id
@@ -195,13 +208,17 @@ struct FolderMetadata extends Metadata
         "Deprecated. Please use :field:`sharing_info` instead."
     sharing_info FolderSharingInfo?
         "Set if the folder is contained in a shared folder or is a shared folder mount point."
+    property_groups List(properties.PropertyGroup)?
+        "Additional information if the file has custom properties with the
+        property template specified."
 
     example default
         id = "id:a4ayc_80_OEAAAAAAAAAXz"
         path_lower = "/homework/math"
         path_display = "/Homework/math"
         name = "math"
         sharing_info = default
+        property_groups = [default]
 
 struct DeletedMetadata extends Metadata
     "Indicates that there used to be a file or folder at this path, but it no longer exists."
@@ -221,6 +238,12 @@ struct GetMetadataArg
         "The path of a file or folder on Dropbox."
     include_media_info Boolean = false
         "If true, :field:`FileMetadata.media_info` is set for photo and video."
+    include_deleted Boolean = false
+        "If true, :type:`DeletedMetadata` will be returned for deleted file or
+        folder, otherwise :field:`LookupError.not_found` will be returned."
+    include_has_explicit_shared_members Boolean = false
+        "If true, the results will include a flag for each file indicating whether or not
+         that file has any explicit members."
 
     example default
         path = "/Homework/math"
@@ -294,6 +317,9 @@ struct ListFolderArg
         "If true, :field:`FileMetadata.media_info` is set for photo and video."
     include_deleted Boolean = false
         "If true, the results will include entries for files and folders that used to exist but were deleted."
+    include_has_explicit_shared_members Boolean = false
+        "If true, the results will include a flag for each file indicating whether or not
+         that file has any explicit members."
 
     example default
         path = "/Homework/math"
@@ -419,6 +445,8 @@ union UploadSessionLookupError
     closed
         "You are attempting to append data to an upload session that
         has alread been closed (i.e. committed)."
+    not_closed
+        "The session must be closed before calling upload_session/finish_batch."
     other*
         "An unspecified error."
 
@@ -427,11 +455,22 @@ union UploadSessionFinishError
         "The session arguments are incorrect; the value explains the reason."
     path WriteError
         "Unable to save the uploaded contents to a file."
+    too_many_shared_folder_targets
+        "The batch request commits files into too many different shared folders.
+        Please limit your batch request to files contained in a single shared folder."
     other*
         "An unspecified error."
 
 # Req/Resp
 
+struct UploadSessionStartArg
+    close Boolean = false
+        "If true, current session will be closed. You cannot do
+        :route:`upload_session/append` any more to current session"
+
+    example with_close
+        close = true
+
 struct UploadSessionStartResult
     session_id String
         "A unique identifier for the upload session. Pass this to
@@ -441,7 +480,7 @@ struct UploadSessionStartResult
     example default
         session_id = "1234faaf0678bcde"
 
-route upload_session/start (Void, UploadSessionStartResult, Void)
+route upload_session/start (UploadSessionStartArg, UploadSessionStartResult, Void)
     "Upload sessions allow you to upload a single file using multiple requests.
     This call starts a new upload session with the given data.  You can
     then use :route:`upload_session/append` to add more data and
@@ -453,6 +492,28 @@ route upload_session/start (Void, UploadSessionStartResult, Void)
         host="content"
         style="upload"
 
+struct UploadSessionAppendArg
+    cursor UploadSessionCursor
+        "Contains the upload session ID and the offset."
+    close Boolean = false
+        "If true, current session will be closed. You cannot do
+        :route:`upload_session/append` any more to current session"
+
+    example default
+        cursor = default
+
+route upload_session/append_v2 (UploadSessionAppendArg, Void, UploadSessionLookupError)
+    "Append more data to an upload session.
+
+    When the parameter close is set, this call will close the session.
+
+    A single request should not upload more than 150 MB of file contents."
+
+    attrs
+        host="content"
+        style="upload"
+
+
 struct UploadSessionCursor
     session_id String
         "The upload session ID (returned by :route:`upload_session/start`)."
@@ -465,7 +526,7 @@ struct UploadSessionCursor
         session_id = "1234faaf0678bcde"
         offset = 0
 
-route upload_session/append (UploadSessionCursor, Void, UploadSessionLookupError)
+route upload_session/append (UploadSessionCursor, Void, UploadSessionLookupError) deprecated by upload_session/append_v2
     "Append more data to an upload session.
 
     A single request should not upload more than 150 MB of file contents."
@@ -660,7 +721,9 @@ union SearchError
         "An unspecified error."
 
 route search (SearchArg, SearchResult, SearchError)
-    "Searches for files and folders."
+    "Searches for files and folders.
+
+    Note: Recent changes may not immediately be reflected in search results due to a short delay in indexing."
 
 #
 # Errors shared by various operations
@@ -961,3 +1024,103 @@ union RestoreError
 
 route restore(RestoreArg, FileMetadata, RestoreError)
     "Restore a file to a specific revision"
+
+
+#
+# Temporary link
+#
+
+struct GetTemporaryLinkArg
+    path ReadPath
+        "The path to the file you want a temporary link to."
+
+    example default
+        path = "/video.mp4"
+
+struct GetTemporaryLinkResult
+    metadata FileMetadata
+        "Metadata of the file."
+    link String
+        "The temporary link which can be used to stream content the file."
+
+    example default
+        metadata = default
+        link = "https://dl.dropboxusercontent.com/apitl/1/YXNkZmFzZGcyMzQyMzI0NjU2NDU2NDU2"
+
+union GetTemporaryLinkError
+    path LookupError
+
+    other*
+
+route get_temporary_link(GetTemporaryLinkArg, GetTemporaryLinkResult, GetTemporaryLinkError)
+    "Get a temporary link to stream content of a file. This link will expire in four hours and
+    afterwards you will get 410 Gone. Content-Type of the link is determined automatically by
+    the file's mime type."
+
+
+#
+# Copy reference
+#
+
+struct GetCopyReferenceArg
+    path ReadPath
+        "The path to the file or folder you want to get a copy reference to."
+
+    example default
+        path = "/video.mp4"
+
+struct GetCopyReferenceResult
+    metadata Metadata
+        "Metadata of the file or folder."
+    copy_reference String
+        "A copy reference to the file or folder."
+    expires common.DropboxTimestamp
+        "The expiration date of the copy reference. This value is currently set to be
+        far enough in the future so that expiration is effectively not an issue."
+
+    example default
+        metadata = default
+        copy_reference = "z1X6ATl6aWtzOGq0c3g5Ng"
+        expires = "2045-05-12T15:50:38Z"
+
+union GetCopyReferenceError
+    path LookupError
+    other*
+
+route copy_reference/get(GetCopyReferenceArg, GetCopyReferenceResult, GetCopyReferenceError)
+    "Get a copy reference to a file or folder. This reference string can be used to
+    save that file or folder to another user's Dropbox by passing it to
+    :route:`copy_reference/save`."
+
+struct SaveCopyReferenceArg
+    copy_reference String
+        "A copy reference returned by :route:`copy_reference/get`."
+
+    path Path
+        "Path in the user's Dropbox that is the destination."
+
+    example default
+        copy_reference = "z1X6ATl6aWtzOGq0c3g5Ng"
+        path = "/video.mp4"
+
+struct SaveCopyReferenceResult
+    metadata Metadata
+        "The metadata of the saved file or folder in the user's Dropbox."
+
+    example default
+        metadata = default
+
+union SaveCopyReferenceError
+    path WriteError
+    invalid_copy_reference
+        "The copy reference is invalid."
+    no_permission
+        "The app has no permission to access another user's Dropbox."
+    not_found
+        "The file referenced by the copy reference cannot be found."
+    too_many_files
+        "The operation would involve more than 10,000 files and folders."
+    other*
+
+route copy_reference/save(SaveCopyReferenceArg, SaveCopyReferenceResult, SaveCopyReferenceError)
+    "Save a copy reference returned by :route:`copy_reference/get` to the user's Dropbox."

properties.babel

@@ -0,0 +1,123 @@
+namespace properties
+    "This namespace contains helper entities for property and property/template endpoints."
+
+alias TemplateId = String(min_length=1,pattern="(/|ptid:).*")
+
+struct PropertyGroupTemplate
+    "Describes property templates that can be filled and associated with a file."
+
+    name String
+        "A display name for the property template. Property template names can
+        be up to 256 bytes."
+    description String
+        "Description for new property template. Property template descriptions
+        can be up to 1024 bytes."
+    fields List(PropertyFieldTemplate)
+        "This is a list of custom properties associated with a property template.
+        There can be up to 64 properties in a single property template."
+
+    example default
+        name = "Security"
+        description = "These properties describe how confidential this file is."
+        fields = [default]
+
+struct PropertyFieldTemplate
+    "Describe a single property field type which that can be part of a property template."
+
+    name String
+        "This is the name or key of a custom property in a property template.
+        File property names can be up to 256 bytes."
+    description String
+        "This is the description for a custom property in a property template.
+        File property description can be up to 1024 bytes."
+    type PropertyType
+        "This is the data type of the value of this property. This type
+        will be enforced upon property creation and modifications."
+
+    example default
+        name = "Security Policy"
+        description = "This is the security policy of the file or folder described.
+        Policies can be Confidential, Public or Internal."
+        type = default
+
+union ModifyPropertyTemplateError extends PropertyTemplateError
+    conflicting_property_names
+        "A property field name already exists in the template."
+    too_many_properties
+        "There are too many properties in the changed template.
+        The maximum number of properties per template is 32."
+    too_many_templates
+        "There are too many templates for the team."
+    template_attribute_too_large
+        "The template name, description or field names is too large."
+
+union PropertyTemplateError
+    template_not_found TemplateId
+        "Property template does not exist for given identifier."
+    restricted_content
+        "You do not have the permissions to modify this property template."
+    other*
+        "An unspecified error."
+
+struct PropertyGroup
+    "Collection of custom properties in filled property templates."
+
+    template_id TemplateId
+        "A unique identifier for a property template type."
+    fields List(PropertyField)
+        "This is a list of custom properties associated with a file.
+        There can be up to 32 properties for a template."
+
+    example default
+        template_id = "ptid:1a5n2i6d3OYEAAAAAAAAAYa"
+        fields = [default]
+
+struct PropertyField
+    name String
+        "This is the name or key of a custom property in a property template.
+        File property names can be up to 256 bytes."
+    value String
+        "Value of a custom property attached to a file. Values can be up to 1024
+        bytes."
+
+    example default
+        name = "Security Policy"
+        value = "Confidential"
+
+union PropertyType
+    "Data type of the given property added. This endpoint is in beta and
+     only properties of type strings is supported."
+
+    string
+        "The associated property will be of type string. Unicode is supported."
+    other*
+
+    example default
+        string = null
+
+#
+# Shared struct used for /template/list and /template/get
+#
+
+struct GetPropertyTemplateArg
+    template_id TemplateId
+        "An identifier for property template added by route properties/template/add."
+
+    example default
+        template_id = "ptid:1a5n2i6d3OYEAAAAAAAAAYa"
+
+struct GetPropertyTemplateResult extends PropertyGroupTemplate
+    "The Property template for the specified template."
+
+    example default
+        name = "Security"
+        description = "These properties describe how confidential this file is."
+        fields = [default]
+
+struct ListPropertyTemplateIds
+    template_ids List(TemplateId)
+        "List of identifiers for templates added by route properties/template/add."
+
+    example default
+        template_ids = ["ptid:1a5n2i6d3OYEAAAAAAAAAYa"]
+