# Copyright 2018 - Stomakun <https://github.com/stomakun>
# SPDX-License-Identifier: UNLICENSED

# This file is taken from https://github.com/stomakun/DropboxSwagger

openapi: 3.0.1
info:
  title: Dropbox User API v2
  description: >-
    The Dropbox API allows developers to work with files in Dropbox, including
    advanced functionality like full-text search, thumbnails, and sharing.
  version: 1.0.0
servers:
  - url: //api.dropbox.com/2
paths:
  /files/properties/update:
    post:
      summary: Files - Properties - Update
      operationId: FilesPropertiesUpdate
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePropertiesArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdatePropertiesError'
      x-codegen-request-body-name: body
  /files/move:
    post:
      summary: Files - Move
      description: |-
        Move a file or folder to a different location in the user's Dropbox.
        If the source path is a folder all its contents will be moved.
      operationId: FilesMove
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelocationArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Metadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationError'
      x-codegen-request-body-name: body
  /sharing/relinquish_file_membership:
    post:
      summary: Sharing - Relinquish File Membership
      description: >-
        The current user relinquishes their membership in the designated file.
        Note that the current user may still have inherited access to this file
        through the parent folder.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingRelinquishFileMembership
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelinquishFileMembershipArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelinquishFileMembershipError'
      x-codegen-request-body-name: body
  /sharing/list_folder_members:
    post:
      summary: Sharing - List Folder Members
      description: |-
        Returns shared folder membership by its folder ID.
        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingListFolderMembers
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFolderMembersArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFolderMembers'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFolderAccessError'
      x-codegen-request-body-name: body
  /sharing/get_folder_metadata:
    post:
      summary: Sharing - Get Folder Metadata
      description: |-
        Returns shared folder metadata by its folder ID.
        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingGetFolderMetadata
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetMetadataArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFolderMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFolderAccessError'
      x-codegen-request-body-name: body
  /users/get_current_account:
    post:
      summary: Users - Get Current Account
      description: Get information about the current user's account.
      operationId: UsersGetCurrentAccount
      requestBody:
        content:
          application/json: {}
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FullAccount'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /paper/docs/users/list:
    post:
      summary: Paper - Docs - Users - List
      description: >-
        Lists all users who visited the Paper doc or users with explicit access.
        This call excludes users who have been removed. The list is sorted by
        the date of the visit or the share date.

        The list will include both users, the explicitly shared ones as well as
        those who came in using the Paper url link.
      operationId: PaperDocsUsersList
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListUsersOnPaperDocArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUsersOnPaperDocResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /sharing/unshare_file:
    post:
      summary: Sharing - Unshare File
      description: Remove all members from this file. Does not remove inherited members.
      operationId: SharingUnshareFile
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UnshareFileArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnshareFileError'
      x-codegen-request-body-name: body
  /sharing/revoke_shared_link:
    post:
      summary: Sharing - Revoke Shared Link
      description: >-
        Revoke a shared link.

        Note that even after revoking a shared link to a file, the file may be
        accessible if there are shared links leading to any of the file parent
        folders. To list all shared links that enable access to a specific file,
        you can use the :route:`list_shared_links` with the file as the
        :field:`ListSharedLinksArg.path` argument.
      operationId: SharingRevokeSharedLink
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RevokeSharedLinkArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RevokeSharedLinkError'
      x-codegen-request-body-name: body
  /sharing/check_remove_member_job_status:
    post:
      summary: Sharing - Check Remove Member Job Status
      description: |-
        Returns the status of an asynchronous job for sharing a folder.
        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingCheckRemoveMemberJobStatus
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemoveMemberJobStatus'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollError'
      x-codegen-request-body-name: body
  /sharing/update_file_member:
    post:
      summary: Sharing - Update File Member
      description: Changes a member's access on a shared file.
      operationId: SharingUpdateFileMember
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFileMemberArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemberAccessLevelResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMemberActionError'
      x-codegen-request-body-name: body
  /files/upload_session/finish_batch/check:
    post:
      summary: Files - Upload Session - Finish Batch - Check
      description: >-
        Returns the status of an asynchronous job for
        :route:`upload_session/finish_batch`. If success, it returns list of
        result for each entry.
      operationId: FilesUploadSessionFinishBatchCheck
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadSessionFinishBatchJobStatus'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollError'
      x-codegen-request-body-name: body
  /files/delete_batch:
    post:
      summary: Files - Delete Batch
      description: >-
        Delete multiple files/folders at once.

        This route is asynchronous, which returns a job ID immediately and runs
        the delete batch asynchronously. Use :route:`delete_batch/check` to
        check the job status.
      operationId: FilesDeleteBatch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteBatchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteBatchLaunch'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /files/create_folder_batch/check:
    post:
      summary: Files - Create Folder Batch - Check
      description: >-
        Returns the status of an asynchronous job for
        :route:`create_folder_batch`. If success, it returns list of result for
        each entry.
      operationId: FilesCreateFolderBatchCheck
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateFolderBatchJobStatus'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollError'
      x-codegen-request-body-name: body
  /sharing/mount_folder:
    post:
      summary: Sharing - Mount Folder
      description: >-
        The current user mounts the designated folder.

        Mount a shared folder for a user after they have been added as a member.
        Once mounted, the shared folder will appear in their Dropbox.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingMountFolder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MountFolderArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFolderMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MountFolderError'
      x-codegen-request-body-name: body
  /files/restore:
    post:
      summary: Files - Restore
      description: Restore a file to a specific revision.
      operationId: FilesRestore
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RestoreArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestoreError'
      x-codegen-request-body-name: body
  /file_requests/update:
    post:
      summary: File Requests - Update
      description: Update a file request.
      operationId: FileRequestsUpdate
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFileRequestArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileRequest'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateFileRequestError'
      x-codegen-request-body-name: body
  /file_properties/templates/remove_for_team:
    post:
      summary: File Properties - Templates - Remove For Team
      description: >-
        Permanently removes the specified template created from
        :route:`templates/add_for_user`. All properties associated with the
        template will also be removed. This action cannot be undone.
      operationId: FilePropertiesTemplatesRemoveForTeam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemoveTemplateArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateError'
      x-codegen-request-body-name: body
  /files/properties/template/get:
    post:
      summary: Files - Properties - Template - Get
      operationId: FilesPropertiesTemplateGet
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTemplateArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateError'
      x-codegen-request-body-name: body
  /paper/docs/get_folder_info:
    post:
      summary: Paper - Docs - Get Folder Info
      description: >-
        Retrieves folder information for the given Paper doc. This includes:
          - folder sharing policy; permissions for subfolders are set by the top-level folder.
          - full 'filepath', i.e. the list of folders (both folderId and folderName) from     the root folder to the folder directly containing the Paper doc.

        Note: If the Paper doc is not in any folder (aka unfiled) the response
        will be empty.
      operationId: PaperDocsGetFolderInfo
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefPaperDoc'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FoldersContainingPaperDoc'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /files/copy_batch:
    post:
      summary: Files - Copy Batch
      description: >-
        Copy multiple files or folders to different locations at once in the
        user's Dropbox.

        If :field:`RelocationBatchArg.allow_shared_folder` is false, this route
        is atomic. If on entry failes, the whole transaction will abort. If
        :field:`RelocationBatchArg.allow_shared_folder` is true, not atomicity
        is guaranteed, but you will be able to copy the contents of shared
        folders to new locations.

        This route will return job ID immediately and do the async copy job in
        background. Please use :route:`copy_batch/check` to check the job
        status.
      operationId: FilesCopyBatch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelocationBatchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationBatchLaunch'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /file_properties/properties/search:
    post:
      summary: File Properties - Properties - Search
      description: Search across property templates for particular property field values.
      operationId: FilePropertiesPropertiesSearch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PropertiesSearchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PropertiesSearchResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PropertiesSearchError'
      x-codegen-request-body-name: body
  /files/delete:
    post:
      summary: Files - Delete
      description: >-
        Delete the file or folder at a given path.

        If the path is a folder, all its contents will be deleted too.

        A successful response indicates that the file or folder was deleted. The
        returned metadata will be the corresponding :type:`FileMetadata` or
        :type:`FolderMetadata` for the item at time of deletion, and not a
        :type:`DeletedMetadata` object.
      operationId: FilesDelete
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Metadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteError'
      x-codegen-request-body-name: body
  /files/properties/add:
    post:
      summary: Files - Properties - Add
      operationId: FilesPropertiesAdd
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddPropertiesArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddPropertiesError'
      x-codegen-request-body-name: body
  /sharing/check_share_job_status:
    post:
      summary: Sharing - Check Share Job Status
      description: |-
        Returns the status of an asynchronous job for sharing a folder.
        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingCheckShareJobStatus
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShareFolderJobStatus'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollError'
      x-codegen-request-body-name: body
  /files/get_thumbnail_batch:
    post:
      summary: Files - Get Thumbnail Batch
      description: >-
        Get thumbnails for a list of images. We allow up to 25 thumbnails in a
        single batch.

        This method currently supports files with the following file extensions:
        jpg, jpeg, png, tiff, tif, gif and bmp. Photos that are larger than 20MB
        in size won't be converted to a thumbnail.
      operationId: FilesGetThumbnailBatch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetThumbnailBatchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetThumbnailBatchResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetThumbnailBatchError'
      x-codegen-request-body-name: body
  /sharing/remove_folder_member:
    post:
      summary: Sharing - Remove Folder Member
      description: >-
        Allows an owner or editor (if the ACL update policy allows) of a shared
        folder to remove another member.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingRemoveFolderMember
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemoveFolderMemberArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LaunchResultBase'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemoveFolderMemberError'
      x-codegen-request-body-name: body
  /sharing/update_folder_member:
    post:
      summary: Sharing - Update Folder Member
      description: >-
        Allows an owner or editor of a shared folder to update another member's
        permissions.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingUpdateFolderMember
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFolderMemberArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemberAccessLevelResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateFolderMemberError'
      x-codegen-request-body-name: body
  /sharing/create_shared_link_with_settings:
    post:
      summary: Sharing - Create Shared Link With Settings
      description: >-
        Create a shared link with custom settings. If no settings are given then
        the default visibility is :field:`RequestedVisibility.public` (The
        resolved visibility, though, may depend on other aspects such as team
        and shared folder settings).
      operationId: SharingCreateSharedLinkWithSettings
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSharedLinkWithSettingsArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedLinkMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSharedLinkWithSettingsError'
      x-codegen-request-body-name: body
  /file_properties/properties/update:
    post:
      summary: File Properties - Properties - Update
      description: >-
        Add, update or remove properties associated with the supplied file and
        templates. This endpoint should be used instead of
        :route:`properties/overwrite` when property groups are being updated via
        a "delta" instead of via a "snapshot" . In other words, this endpoint
        will not delete any omitted fields from a property group, whereas
        :route:`properties/overwrite` will delete any fields that are omitted
        from a property group.
      operationId: FilePropertiesPropertiesUpdate
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePropertiesArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdatePropertiesError'
      x-codegen-request-body-name: body
  /sharing/unmount_folder:
    post:
      summary: Sharing - Unmount Folder
      description: >-
        The current user unmounts the designated folder. They can re-mount the
        folder at a later time using :route:`mount_folder`.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingUnmountFolder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UnmountFolderArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnmountFolderError'
      x-codegen-request-body-name: body
  /sharing/list_received_files:
    post:
      summary: Sharing - List Received Files
      description: |-
        Returns a list of all files shared with current user.
         Does not include files the user has received via shared folders, and does  not include unclaimed invitations.
      operationId: SharingListReceivedFiles
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFilesArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFilesResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharingUserError'
      x-codegen-request-body-name: body
  /paper/docs/sharing_policy/set:
    post:
      summary: Paper - Docs - Sharing Policy - Set
      description: >-
        Sets the default sharing policy for the given Paper doc. The default
        'team_sharing_policy' can be changed only by teams, omit this field for
        personal accounts.


        Note: 'public_sharing_policy' cannot be set to the value 'disabled'
        because this setting can be changed only via the team admin console.
      operationId: PaperDocsSharingPolicySet
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PaperDocSharingPolicy'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /files/properties/remove:
    post:
      summary: Files - Properties - Remove
      operationId: FilesPropertiesRemove
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemovePropertiesArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemovePropertiesError'
      x-codegen-request-body-name: body
  /files/copy_batch/check:
    post:
      summary: Files - Copy Batch - Check
      description: >-
        Returns the status of an asynchronous job for :route:`copy_batch`. If
        success, it returns list of results for each entry.
      operationId: FilesCopyBatchCheck
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationBatchJobStatus'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollError'
      x-codegen-request-body-name: body
  /files/move_batch/check:
    post:
      summary: Files - Move Batch - Check
      description: >-
        Returns the status of an asynchronous job for :route:`move_batch`. If
        success, it returns list of results for each entry.
      operationId: FilesMoveBatchCheck
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationBatchJobStatus'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollError'
      x-codegen-request-body-name: body
  /files/list_folder/get_latest_cursor:
    post:
      summary: Files - List Folder - Get Latest Cursor
      description: >-
        A way to quickly get a cursor for the folder's state. Unlike
        :route:`list_folder`, :route:`list_folder/get_latest_cursor` doesn't
        return any entries. This endpoint is for app which only needs to know
        about new files and modifications and doesn't need to know about files
        that already exist in Dropbox.
      operationId: FilesListFolderGetLatestCursor
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFolderArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderGetLatestCursorResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderError'
      x-codegen-request-body-name: body
  /paper/docs/sharing_policy/get:
    post:
      summary: Paper - Docs - Sharing Policy - Get
      description: Gets the default sharing policy for the given Paper doc.
      operationId: PaperDocsSharingPolicyGet
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefPaperDoc'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharingPolicy'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /sharing/share_folder:
    post:
      summary: Sharing - Share Folder
      description: >-
        Share a folder with collaborators.

        Most sharing will be completed synchronously. Large folders will be
        completed asynchronously. To make testing the async case repeatable, set
        `ShareFolderArg.force_async`.

        If a :field:`ShareFolderLaunch.async_job_id` is returned, you'll need to
        call :route:`check_share_job_status` until the action completes to get
        the metadata for the folder.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingShareFolder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ShareFolderArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShareFolderLaunch'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShareFolderError'
      x-codegen-request-body-name: body
  /files/save_url/check_job_status:
    post:
      summary: Files - Save Url - Check Job Status
      description: Check the status of a :route:`save_url` job.
      operationId: FilesSaveUrlCheckJobStatus
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SaveUrlJobStatus'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollError'
      x-codegen-request-body-name: body
  /paper/docs/users/add:
    post:
      summary: Paper - Docs - Users - Add
      description: >-
        Allows an owner or editor to add users to a Paper doc or change their
        permissions using their email address or Dropbox account ID.


        Note: The Doc owner's permissions cannot be changed.
      operationId: PaperDocsUsersAdd
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddPaperDocUser'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AddPaperDocUserMemberResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /files/copy_reference/save:
    post:
      summary: Files - Copy Reference - Save
      description: >-
        Save a copy reference returned by :route:`copy_reference/get` to the
        user's Dropbox.
      operationId: FilesCopyReferenceSave
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveCopyReferenceArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SaveCopyReferenceResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SaveCopyReferenceError'
      x-codegen-request-body-name: body
  /sharing/add_file_member:
    post:
      summary: Sharing - Add File Member
      description: Adds specified members to a file.
      operationId: SharingAddFileMember
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddFileMemberArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/FileMemberActionResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddFileMemberError'
      x-codegen-request-body-name: body
  /sharing/list_folders/continue:
    post:
      summary: Sharing - List Folders - Continue
      description: >-
        Once a cursor has been retrieved from :route:`list_folders`, use this to
        paginate through all shared folders. The cursor must come from a
        previous call to :route:`list_folders` or
        :route:`list_folders/continue`.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingListFoldersContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFoldersContinueArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFoldersResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFoldersContinueError'
      x-codegen-request-body-name: body
  /files/alpha/upload:
    post:
      summary: Files - Alpha - Upload
      description: >-
        Create a new file with the contents provided in the request. Note that
        this endpoint is part of the properties API alpha and is slightly
        different from :route:`upload`.

        Do not use this to upload a file larger than 150 MB. Instead, create an
        upload session with :route:`upload_session/start`.
      operationId: FilesAlphaUpload
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CommitInfoWithProperties'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadErrorWithProperties'
      x-codegen-request-body-name: body
  /files/list_folder/longpoll:
    post:
      summary: Files - List Folder - Longpoll
      description: >-
        A longpoll endpoint to wait for changes on an account. In conjunction
        with :route:`list_folder/continue`, this call gives you a low-latency
        way to monitor an account for file changes. The connection will block
        until there are changes available or a timeout occurs. This endpoint is
        useful mostly for client-side apps. If you're looking for server-side
        notifications, check out our :link:`webhooks documentation
        https://www.dropbox.com/developers/reference/webhooks`.
      operationId: FilesListFolderLongpoll
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFolderLongpollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderLongpollResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderLongpollError'
      x-codegen-request-body-name: body
  /file_properties/templates/remove_for_user:
    post:
      summary: File Properties - Templates - Remove For User
      description: >-
        Permanently removes the specified template created from
        :route:`templates/add_for_user`. All properties associated with the
        template will also be removed. This action cannot be undone.
      operationId: FilePropertiesTemplatesRemoveForUser
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemoveTemplateArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateError'
      x-codegen-request-body-name: body
  /files/get_temporary_link:
    post:
      summary: Files - Get Temporary Link
      description: >-
        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.
      operationId: FilesGetTemporaryLink
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTemporaryLinkArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTemporaryLinkResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTemporaryLinkError'
      x-codegen-request-body-name: body
  /sharing/list_folder_members/continue:
    post:
      summary: Sharing - List Folder Members - Continue
      description: >-
        Once a cursor has been retrieved from :route:`list_folder_members`, use
        this to paginate through all shared folder members.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingListFolderMembersContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFolderMembersContinueArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFolderMembers'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderMembersContinueError'
      x-codegen-request-body-name: body
  /file_properties/templates/add_for_user:
    post:
      summary: File Properties - Templates - Add For User
      description: >-
        Add a template associated with a user. See :route:`properties/add` to
        add properties to a file. This endpoint can't be called on a team member
        or admin's behalf.
      operationId: FilePropertiesTemplatesAddForUser
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddTemplateArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModifyTemplateError'
      x-codegen-request-body-name: body
  /files/upload_session/finish_batch:
    post:
      summary: Files - Upload Session - Finish Batch
      description: >-
        This route helps you commit many files at once into a user's Dropbox.
        Use :route:`upload_session/start` and :route:`upload_session/append_v2`
        to upload file contents. We recommend uploading many files in parallel
        to increase throughput. Once the file contents have been uploaded,
        rather than calling :route:`upload_session/finish`, use this route to
        finish all your upload sessions in a single request.

        :field:`UploadSessionStartArg.close` or
        :field:`UploadSessionAppendArg.close` needs to be true for the last
        :route:`upload_session/start` or :route:`upload_session/append_v2` call.
        The maximum size of a file one can upload to an upload session is 350
        GB.

        This route will return a job_id immediately and do the async commit job
        in background. Use :route:`upload_session/finish_batch/check` to check
        the job status.

        For the same account, this route should be executed serially. That means
        you should not start the next job before current job finishes. We allow
        up to 1000 entries in a single request.
      operationId: FilesUploadSessionFinishBatch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UploadSessionFinishBatchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadSessionFinishBatchLaunch'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /files/upload_session/append_v2:
    post:
      summary: Files - Upload Session - Append V2
      description: >-
        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. The maximum size of
        a file one can upload to an upload session is 350 GB.
      operationId: FilesUploadSessionAppendV2
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UploadSessionAppendArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadSessionLookupError'
      x-codegen-request-body-name: body
  /files/create_folder_v2:
    post:
      summary: Files - Create Folder V2
      description: Create a folder at a given path.
      operationId: FilesCreateFolderV2
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFolderArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateFolderResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateFolderError'
      x-codegen-request-body-name: body
  /files/copy_reference/get:
    post:
      summary: Files - Copy Reference - Get
      description: >-
        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`.
      operationId: FilesCopyReferenceGet
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetCopyReferenceArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCopyReferenceResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCopyReferenceError'
      x-codegen-request-body-name: body
  /paper/docs/users/list/continue:
    post:
      summary: Paper - Docs - Users - List - Continue
      description: >-
        Once a cursor has been retrieved from :route:`docs/users/list`, use this
        to paginate through all users on the Paper doc.
      operationId: PaperDocsUsersListContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListUsersOnPaperDocContinueArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUsersOnPaperDocResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUsersCursorError'
      x-codegen-request-body-name: body
  /file_properties/properties/search/continue:
    post:
      summary: File Properties - Properties - Search - Continue
      description: >-
        Once a cursor has been retrieved from :route:`properties/search`, use
        this to paginate through all search results.
      operationId: FilePropertiesPropertiesSearchContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PropertiesSearchContinueArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PropertiesSearchResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PropertiesSearchContinueError'
      x-codegen-request-body-name: body
  /files/list_folder:
    post:
      summary: Files - List Folder
      description: >-
        Starts returning the contents of a folder. If the result's
        :field:`ListFolderResult.has_more` field is :val:`true`, call
        :route:`list_folder/continue` with the returned
        :field:`ListFolderResult.cursor` to retrieve more entries.

        If you're using :field:`ListFolderArg.recursive` set to :val:`true` to
        keep a local cache of the contents of a Dropbox account, iterate through
        each entry in order and process them as follows to keep your local state
        in sync:

        For each :type:`FileMetadata`, store the new entry at the given path in
        your local state. If the required parent folders don't exist yet, create
        them. If there's already something else at the given path, replace it
        and remove all its children.

        For each :type:`FolderMetadata`, store the new entry at the given path
        in your local state. If the required parent folders don't exist yet,
        create them. If there's already something else at the given path,
        replace it but leave the children as they are. Check the new entry's
        :field:`FolderSharingInfo.read_only` and set all its children's
        read-only statuses to match.

        For each :type:`DeletedMetadata`, if your local state has something at
        the given path, remove it and all its children. If there's nothing at
        the given path, ignore this entry.

        Note: :type:`auth.RateLimitError` may be returned if multiple
        :route:`list_folder` or :route:`list_folder/continue` calls with same
        parameters are made simultaneously by same API app for same user. If
        your app implements retry logic, please hold off the retry until the
        previous request finishes.
      operationId: FilesListFolder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFolderArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderResult'
              examples:
                Testexample:
                  value: { "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu", "entries": [ { ".tag": "file", "client_modified": "2015-05-12T15:50:38Z", "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "file_lock_info": { "created": "2015-05-12T15:50:38Z", "is_lockholder": true, "lockholder_name": "Imaginary User" }, "has_explicit_shared_members": false, "id": "id:a4ayc_80_OEAAAAAAAAAXw", "is_downloadable": true, "name": "test-2021-08-29T04-00-00.tar.gz", "path_display": "/somepath/test-2021-08-29T04-00-00.tar.gz", "path_lower": "/somepath/test-2021-08-29T04-00-00.tar.gz", "property_groups": [ { "fields": [ { "name": "Security Policy", "value": "Confidential" } ], "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa" } ], "rev": "a1c10ce0dd78", "server_modified": "SERVER_MODIFIED_1", "sharing_info": { "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc", "parent_shared_folder_id": "84528192421", "read_only": true }, "size": 7212 }, { ".tag": "folder", "id": "id:a4ayc_80_OEAAAAAAAAAXz", "name": "math", "path_display": "/Homework/math", "path_lower": "/homework/math", "property_groups": [ { "fields": [ { "name": "Security Policy", "value": "Confidential" } ], "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa" } ], "sharing_info": { "no_access": false, "parent_shared_folder_id": "84528192421", "read_only": false, "traverse_only": false } } ], "has_more": true }
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderError'
      x-codegen-request-body-name: body
  /files/upload_session/finish:
    post:
      summary: Files - Upload Session - Finish
      description: >-
        Finish an upload session and save the uploaded data to the given file
        path.

        A single request should not upload more than 150 MB. The maximum size of
        a file one can upload to an upload session is 350 GB.
      operationId: FilesUploadSessionFinish
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UploadSessionFinishArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMetadata'
              examples:
                Testexample:
                  value: { "name": "Prime_Numbers.txt", "id": "id:a4ayc_80_OEAAAAAAAAAXw", "client_modified": "2023-08-22T16:59:57Z", "server_modified": "2023-08-22T16:59:57Z", "rev": "a1c10ce0dd78", "size": 7212, "is_downloadable": true }
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadSessionFinishError'
      x-codegen-request-body-name: body
  /sharing/get_shared_links:
    post:
      summary: Sharing - Get Shared Links
      description: >-
        Returns a list of :type:`LinkMetadata` objects for this user, including
        collection links.

        If no path is given, returns a list of all shared links for the current
        user, including collection links, up to a maximum of 1000 links.

        If a non-empty path is given, returns a list of all shared links that
        allow access to the given path.  Collection links are never returned in
        this case.

        Note that the url field in the response is never the shortened URL.
      operationId: SharingGetSharedLinks
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetSharedLinksArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSharedLinksResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSharedLinksError'
      x-codegen-request-body-name: body
  /files/move_batch:
    post:
      summary: Files - Move Batch
      description: >-
        Move multiple files or folders to different locations at once in the
        user's Dropbox.

        This route is 'all or nothing', which means if one entry fails, the
        whole transaction will abort.

        This route will return job ID immediately and do the async moving job in
        background. Please use :route:`move_batch/check` to check the job
        status.
      operationId: FilesMoveBatch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelocationBatchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationBatchLaunch'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /files/list_folder/continue:
    post:
      summary: Files - List Folder - Continue
      description: >-
        Once a cursor has been retrieved from :route:`list_folder`, use this to
        paginate through all files and retrieve updates to the folder, following
        the same rules as documented for :route:`list_folder`.
      operationId: FilesListFolderContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFolderContinueArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderResult'
              examples:
                Testexample:
                  value: { "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu", "entries": [ { ".tag": "file", "client_modified": "2015-05-12T15:50:38Z", "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "file_lock_info": { "created": "2015-05-12T12:50:38Z", "is_lockholder": true, "lockholder_name": "Imaginary User" }, "has_explicit_shared_members": false, "id": "id:a4ayc_80_OEAAAAAAAAAXw", "is_downloadable": true, "name": "test-2021-08-29T02-00-00.tar.gz", "path_display": "/somepath/test-2021-08-29T02-00-00.tar.gz", "path_lower": "/somepath/test-2021-08-29T02-00-00.tar.gz", "property_groups": [ { "fields": [ { "name": "Security Policy", "value": "Confidential" } ], "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa" } ], "rev": "a1c10ce0dd78", "server_modified": "SERVER_MODIFIED_2", "sharing_info": { "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc", "parent_shared_folder_id": "84528192421", "read_only": true }, "size": 7212 } ], "has_more": false }
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderContinueError'
      x-codegen-request-body-name: body
  /paper/docs/permanently_delete:
    post:
      summary: Paper - Docs - Permanently Delete
      description: >-
        Permanently deletes the given Paper doc. This operation is final as the
        doc cannot be recovered.


        Note: This action can be performed only by the doc owner.
      operationId: PaperDocsPermanentlyDelete
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefPaperDoc'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /users/get_space_usage:
    post:
      summary: Users - Get Space Usage
      description: Get the space usage information for the current user's account.
      operationId: UsersGetSpaceUsage
      requestBody:
        content:
          application/json: {}
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SpaceUsage'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /file_properties/properties/add:
    post:
      summary: File Properties - Properties - Add
      description: >-
        Add property groups to a Dropbox file. See
        :route:`templates/add_for_user` or :route:`templates/add_for_team` to
        create new templates.
      operationId: FilePropertiesPropertiesAdd
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddPropertiesArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddPropertiesError'
      x-codegen-request-body-name: body
  /sharing/add_folder_member:
    post:
      summary: Sharing - Add Folder Member
      description: >-
        Allows an owner or editor (if the ACL update policy allows) of a shared
        folder to add another member.

        For the new member to get access to all the functionality for this
        folder, you will need to call :route:`mount_folder` on their behalf.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingAddFolderMember
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddFolderMemberArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddFolderMemberError'
      x-codegen-request-body-name: body
  /sharing/list_shared_links:
    post:
      summary: Sharing - List Shared Links
      description: >-
        List shared links of this user.

        If no path is given, returns a list of all shared links for the current
        user.

        If a non-empty path is given, returns a list of all shared links that
        allow access to the given path - direct links to the given path and
        links to parent folders of the given path. Links to parent folders can
        be suppressed by setting direct_only to true.
      operationId: SharingListSharedLinks
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListSharedLinksArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSharedLinksResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSharedLinksError'
      x-codegen-request-body-name: body
  /files/upload:
    post:
      summary: Files - Upload
      description: >-
        Create a new file with the contents provided in the request.

        Do not use this to upload a file larger than 150 MB. Instead, create an
        upload session with :route:`upload_session/start`.
      operationId: FilesUpload
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CommitInfo'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadError'
      x-codegen-request-body-name: body
  /file_properties/templates/update_for_user:
    post:
      summary: File Properties - Templates - Update For User
      description: >-
        Update a template associated with a user. This route can update the
        template name, the template description and add optional properties to
        templates. This endpoint can't be called on a team member or admin's
        behalf.
      operationId: FilePropertiesTemplatesUpdateForUser
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateTemplateArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModifyTemplateError'
      x-codegen-request-body-name: body
  /sharing/list_received_files/continue:
    post:
      summary: Sharing - List Received Files - Continue
      description: Get more results with a cursor from :route:`list_received_files`.
      operationId: SharingListReceivedFilesContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFilesContinueArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFilesResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFilesContinueError'
      x-codegen-request-body-name: body
  /files/download_zip:
    post:
      summary: Files - Download Zip
      description: >-
        Download a folder from the user's Dropbox, as a zip file. The folder
        must be less than 1 GB in size and have fewer than 10,000 total files.
        The input cannot be a single file.
      operationId: FilesDownloadZip
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DownloadZipArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DownloadZipResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DownloadZipError'
      x-codegen-request-body-name: body
  /sharing/change_file_member_access:
    post:
      summary: Sharing - Change File Member Access
      description: Identical to update_file_member but with less information returned.
      operationId: SharingChangeFileMemberAccess
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeFileMemberAccessArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMemberActionResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMemberActionError'
      x-codegen-request-body-name: body
  /file_properties/templates/add_for_team:
    post:
      summary: File Properties - Templates - Add For Team
      description: >-
        Add a template associated with a team. See :route:`properties/add` to
        add properties to a file or folder.

        Note: this endpoint will create team-owned templates.
      operationId: FilePropertiesTemplatesAddForTeam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddTemplateArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModifyTemplateError'
      x-codegen-request-body-name: body
  /sharing/modify_shared_link_settings:
    post:
      summary: Sharing - Modify Shared Link Settings
      description: >-
        Modify the shared link's settings.

        If the requested visibility conflict with the shared links policy of the
        team or the shared folder (in case the linked file is part of a shared
        folder) then the :field:`LinkPermissions.resolved_visibility` of the
        returned :type:`SharedLinkMetadata` will reflect the actual visibility
        of the shared link and the :field:`LinkPermissions.requested_visibility`
        will reflect the requested visibility.
      operationId: SharingModifySharedLinkSettings
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ModifySharedLinkSettingsArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedLinkMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModifySharedLinkSettingsError'
      x-codegen-request-body-name: body
  /sharing/create_shared_link:
    post:
      summary: Sharing - Create Shared Link
      description: >-
        Create a shared link.

        If a shared link already exists for the given path, that link is
        returned.

        Note that in the returned :type:`PathLinkMetadata`, the
        :field:`PathLinkMetadata.url` field is the shortened URL if
        :field:`CreateSharedLinkArg.short_url` argument is set to :val:`true`.

        Previously, it was technically possible to break a shared link by moving
        or renaming the corresponding file or folder. In the future, this will
        no longer be the case, so your app shouldn't rely on this behavior.
        Instead, if your app needs to revoke a shared link, use
        :route:`revoke_shared_link`.
      operationId: SharingCreateSharedLink
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSharedLinkArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PathLinkMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSharedLinkError'
      x-codegen-request-body-name: body
  /sharing/remove_file_member:
    post:
      summary: Sharing - Remove File Member
      description: Identical to remove_file_member_2 but with less information returned.
      operationId: SharingRemoveFileMember
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemoveFileMemberArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMemberActionIndividualResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemoveFileMemberError'
      x-codegen-request-body-name: body
  /auth/token/revoke:
    post:
      summary: Auth - Token - Revoke
      description: Disables the access token used to authenticate the call.
      operationId: AuthTokenRevoke
      requestBody:
        content:
          application/json: {}
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /files/copy:
    post:
      summary: Files - Copy
      description: |-
        Copy a file or folder to a different location in the user's Dropbox.
        If the source path is a folder all its contents will be copied.
      operationId: FilesCopy
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelocationArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Metadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationError'
      x-codegen-request-body-name: body
  /sharing/get_shared_link_metadata:
    post:
      summary: Sharing - Get Shared Link Metadata
      description: Get the shared link's metadata.
      operationId: SharingGetSharedLinkMetadata
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetSharedLinkMetadataArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedLinkMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedLinkError'
      x-codegen-request-body-name: body
  /file_properties/properties/overwrite:
    post:
      summary: File Properties - Properties - Overwrite
      description: >-
        Overwrite property groups associated with a file. This endpoint should
        be used instead of :route:`properties/update` when property groups are
        being updated via a "snapshot" instead of via a "delta". In other words,
        this endpoint will delete all omitted fields from a property group,
        whereas :route:`properties/update` will only delete fields that are
        explicitly marked for deletion.
      operationId: FilePropertiesPropertiesOverwrite
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OverwritePropertyGroupArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidPropertyGroupError'
      x-codegen-request-body-name: body
  /files/permanently_delete:
    post:
      summary: Files - Permanently Delete
      description: >-
        Permanently delete the file or folder at a given path (see
        https://www.dropbox.com/en/help/40).

        Note: This endpoint is only available for Dropbox Business apps.
      operationId: FilesPermanentlyDelete
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteError'
      x-codegen-request-body-name: body
  /sharing/unshare_folder:
    post:
      summary: Sharing - Unshare Folder
      description: >-
        Allows a shared folder owner to unshare the folder.

        You'll need to call :route:`check_job_status` to determine if the action
        has completed successfully.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingUnshareFolder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UnshareFolderArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LaunchEmptyResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnshareFolderError'
      x-codegen-request-body-name: body
  /sharing/list_mountable_folders/continue:
    post:
      summary: Sharing - List Mountable Folders - Continue
      description: >-
        Once a cursor has been retrieved from :route:`list_mountable_folders`,
        use this to paginate through all mountable shared folders. The cursor
        must come from a previous call to :route:`list_mountable_folders` or
        :route:`list_mountable_folders/continue`.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingListMountableFoldersContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFoldersContinueArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFoldersResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFoldersContinueError'
      x-codegen-request-body-name: body
  /file_properties/templates/get_for_team:
    post:
      summary: File Properties - Templates - Get For Team
      description: Get the schema for a specified template.
      operationId: FilePropertiesTemplatesGetForTeam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTemplateArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateError'
      x-codegen-request-body-name: body
  /sharing/relinquish_folder_membership:
    post:
      summary: Sharing - Relinquish Folder Membership
      description: >-
        The current user relinquishes their membership in the designated shared
        folder and will no longer have access to the folder.  A folder owner
        cannot relinquish membership in their own folder.

        This will run synchronously if leave_a_copy is false, and asynchronously
        if leave_a_copy is true. Apps must have full Dropbox access to use this
        endpoint.
      operationId: SharingRelinquishFolderMembership
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelinquishFolderMembershipArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LaunchEmptyResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelinquishFolderMembershipError'
      x-codegen-request-body-name: body
  /files/download:
    post:
      summary: Files - Download
      description: Download a file from a user's Dropbox.
      operationId: FilesDownload
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DownloadArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DownloadError'
      x-codegen-request-body-name: body
  /files/search:
    post:
      summary: Files - Search
      description: >-
        Searches for files and folders.

        Note: Recent changes may not immediately be reflected in search results
        due to a short delay in indexing.
      operationId: FilesSearch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchError'
      x-codegen-request-body-name: body
  /sharing/get_file_metadata:
    post:
      summary: Sharing - Get File Metadata
      description: Returns shared file metadata.
      operationId: SharingGetFileMetadata
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetFileMetadataArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFileMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFileMetadataError'
      x-codegen-request-body-name: body
  /sharing/list_mountable_folders:
    post:
      summary: Sharing - List Mountable Folders
      description: >-
        Return the list of all shared folders the current user can mount or
        unmount.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingListMountableFolders
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFoldersArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFoldersResult'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /file_properties/templates/list_for_team:
    post:
      summary: File Properties - Templates - List For Team
      description: >-
        Get the template identifiers for a team. To get the schema of each
        template use :route:`templates/get_for_team`.
      operationId: FilePropertiesTemplatesListForTeam
      requestBody:
        content:
          application/json: {}
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateError'
      x-codegen-request-body-name: body
  /file_properties/properties/remove:
    post:
      summary: File Properties - Properties - Remove
      description: >-
        Permanently removes the specified property group from the file. To
        remove specific property field key value pairs, see
        :route:`properties/update`. To update a template, see
        :route:`templates/update_for_user` or
        :route:`templates/update_for_team`. To remove a template, see
        :route:`templates/remove_for_user` or
        :route:`templates/remove_for_team`.
      operationId: FilePropertiesPropertiesRemove
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemovePropertiesArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemovePropertiesError'
      x-codegen-request-body-name: body
  /files/create_folder:
    post:
      summary: Files - Create Folder
      description: Create a folder at a given path.
      operationId: FilesCreateFolder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFolderArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FolderMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateFolderError'
      x-codegen-request-body-name: body
  /file_requests/list:
    post:
      summary: File Requests - List
      description: >-
        Returns a list of file requests owned by this user. For apps with the
        app folder permission, this will only return file requests with
        destinations in the app folder.
      operationId: FileRequestsList
      requestBody:
        content:
          application/json: {}
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFileRequestsResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFileRequestsError'
      x-codegen-request-body-name: body
  /paper/docs/archive:
    post:
      summary: Paper - Docs - Archive
      description: >-
        Marks the given Paper doc as archived.

        Note: This action can be performed or undone by anyone with edit
        permissions to the doc.
      operationId: PaperDocsArchive
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefPaperDoc'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /users/get_account_batch:
    post:
      summary: Users - Get Account Batch
      description: >-
        Get information about multiple user accounts.  At most 300 accounts may
        be queried per request.
      operationId: UsersGetAccountBatch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetAccountBatchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BasicAccount'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountBatchError'
      x-codegen-request-body-name: body
  /file_requests/create:
    post:
      summary: File Requests - Create
      description: Creates a file request for this user.
      operationId: FileRequestsCreate
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFileRequestArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileRequest'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateFileRequestError'
      x-codegen-request-body-name: body
  /sharing/list_file_members:
    post:
      summary: Sharing - List File Members
      description: >-
        Use to obtain the members who have been invited to a file, both
        inherited and uninherited members.
      operationId: SharingListFileMembers
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFileMembersArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFileMembers'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFileMembersError'
      x-codegen-request-body-name: body
  /file_properties/templates/update_for_team:
    post:
      summary: File Properties - Templates - Update For Team
      description: >-
        Update a template associated with a team. This route can update the
        template name, the template description and add optional properties to
        templates.
      operationId: FilePropertiesTemplatesUpdateForTeam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateTemplateArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModifyTemplateError'
      x-codegen-request-body-name: body
  /sharing/list_file_members/continue:
    post:
      summary: Sharing - List File Members - Continue
      description: >-
        Once a cursor has been retrieved from :route:`list_file_members` or
        :route:`list_file_members/batch`, use this to paginate through all
        shared file members.
      operationId: SharingListFileMembersContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFileMembersContinueArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFileMembers'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFileMembersContinueError'
      x-codegen-request-body-name: body
  /paper/docs/update:
    post:
      summary: Paper - Docs - Update
      description: Updates an existing Paper doc with the provided content.
      operationId: PaperDocsUpdate
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PaperDocUpdateArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaperDocCreateUpdateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaperDocUpdateError'
      x-codegen-request-body-name: body
  /auth/token/from_oauth1:
    post:
      summary: Auth - Token - From Oauth1
      description: >-
        Creates an OAuth 2.0 access token from the supplied OAuth 1.0 access
        token.
      operationId: AuthTokenFromOauth1
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TokenFromOAuth1Arg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenFromOAuth1Result'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenFromOAuth1Error'
      x-codegen-request-body-name: body
  /files/properties/overwrite:
    post:
      summary: Files - Properties - Overwrite
      operationId: FilesPropertiesOverwrite
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OverwritePropertyGroupArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidPropertyGroupError'
      x-codegen-request-body-name: body
  /file_requests/get:
    post:
      summary: File Requests - Get
      description: Returns the specified file request.
      operationId: FileRequestsGet
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetFileRequestArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileRequest'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFileRequestError'
      x-codegen-request-body-name: body
  /paper/docs/list/continue:
    post:
      summary: Paper - Docs - List - Continue
      description: >-
        Once a cursor has been retrieved from :route:`docs/list`, use this to
        paginate through all Paper doc.
      operationId: PaperDocsListContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListPaperDocsContinueArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPaperDocsResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListDocsCursorError'
      x-codegen-request-body-name: body
  /files/get_thumbnail:
    post:
      summary: Files - Get Thumbnail
      description: >-
        Get a thumbnail for an image.

        This method currently supports files with the following file extensions:
        jpg, jpeg, png, tiff, tif, gif and bmp. Photos that are larger than 20MB
        in size won't be converted to a thumbnail.
      operationId: FilesGetThumbnail
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ThumbnailArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThumbnailError'
      x-codegen-request-body-name: body
  /sharing/update_folder_policy:
    post:
      summary: Sharing - Update Folder Policy
      description: >-
        Update the sharing policies for a shared folder.

        User must have :field:`AccessLevel.owner` access to the shared folder to
        update its policies.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingUpdateFolderPolicy
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFolderPolicyArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedFolderMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateFolderPolicyError'
      x-codegen-request-body-name: body
  /sharing/set_access_inheritance:
    post:
      summary: Sharing - Set Access Inheritance
      description: >-
        Change the inheritance policy of an existing Shared Folder. Only
        permitted for shared folders in a shared team root.

        If a :field:`ShareFolderLaunch.async_job_id` is returned, you'll need to
        call :route:`check_share_job_status` until the action completes to get
        the metadata for the folder.
      operationId: SharingSetAccessInheritance
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetAccessInheritanceArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShareFolderLaunch'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetAccessInheritanceError'
      x-codegen-request-body-name: body
  /files/save_url:
    post:
      summary: Files - Save Url
      description: >-
        Save a specified URL into a file in user's Dropbox. If the given path
        already exists, the file will be renamed to avoid the conflict (e.g.
        myfile (1).txt).
      operationId: FilesSaveUrl
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveUrlArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SaveUrlResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SaveUrlError'
      x-codegen-request-body-name: body
  /files/alpha/get_metadata:
    post:
      summary: Files - Alpha - Get Metadata
      description: >-
        Returns the metadata for a file or folder. This is an alpha endpoint
        compatible with the properties API.

        Note: Metadata for the root folder is unsupported.
      operationId: FilesAlphaGetMetadata
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AlphaGetMetadataArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Metadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlphaGetMetadataError'
      x-codegen-request-body-name: body
  /sharing/remove_file_member_2:
    post:
      summary: Sharing - Remove File Member 2
      description: Removes a specified member from the file.
      operationId: SharingRemoveFileMember2
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemoveFileMemberArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMemberRemoveActionResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemoveFileMemberError'
      x-codegen-request-body-name: body
  /files/copy_v2:
    post:
      summary: Files - Copy V2
      description: |-
        Copy a file or folder to a different location in the user's Dropbox.
        If the source path is a folder all its contents will be copied.
      operationId: FilesCopyV2
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelocationArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationError'
      x-codegen-request-body-name: body
  /files/upload_session/start:
    post:
      summary: Files - Upload Session - Start
      description: >-
        Upload sessions allow you to upload a single file in one or more
        requests, for example where the size of the file is greater than 150
        MB.  This call starts a new upload session with the given data. You can
        then use :route:`upload_session/append_v2` to add more data and
        :route:`upload_session/finish` to save all the data to a file in
        Dropbox.

        A single request should not upload more than 150 MB. The maximum size of
        a file one can upload to an upload session is 350 GB.

        An upload session can be used for a maximum of 48 hours. Attempting to
        use an :field:`UploadSessionStartResult.session_id` with
        :route:`upload_session/append_v2` or :route:`upload_session/finish` more
        than 48 hours after its creation will return a
        :field:`UploadSessionLookupError.not_found`.
      operationId: FilesUploadSessionStart
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UploadSessionStartArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadSessionStartResult'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /file_properties/templates/list_for_user:
    post:
      summary: File Properties - Templates - List For User
      description: >-
        Get the template identifiers for a team. To get the schema of each
        template use :route:`templates/get_for_user`. This endpoint can't be
        called on a team member or admin's behalf.
      operationId: FilePropertiesTemplatesListForUser
      requestBody:
        content:
          application/json: {}
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateError'
      x-codegen-request-body-name: body
  /files/create_folder_batch:
    post:
      summary: Files - Create Folder Batch
      description: >-
        Create multiple folders at once.

        This route is asynchronous for large batches, which returns a job ID
        immediately and runs the create folder batch asynchronously. Otherwise,
        creates the folders and returns the result synchronously for smaller
        inputs. You can force asynchronous behaviour by using the
        :field:`CreateFolderBatchArg.force_async` flag.  Use
        :route:`create_folder_batch/check` to check the job status.
      operationId: FilesCreateFolderBatch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFolderBatchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateFolderBatchLaunch'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /users/get_account:
    post:
      summary: Users - Get Account
      description: Get information about a user's account.
      operationId: UsersGetAccount
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetAccountArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BasicAccount'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountError'
      x-codegen-request-body-name: body
  /files/move_v2:
    post:
      summary: Files - Move V2
      description: |-
        Move a file or folder to a different location in the user's Dropbox.
        If the source path is a folder all its contents will be moved.
      operationId: FilesMoveV2
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelocationArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelocationError'
      x-codegen-request-body-name: body
  /paper/docs/folder_users/list/continue:
    post:
      summary: Paper - Docs - Folder Users - List - Continue
      description: >-
        Once a cursor has been retrieved from :route:`docs/folder_users/list`,
        use this to paginate through all users on the Paper folder.
      operationId: PaperDocsFolderUsersListContinue
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListUsersOnFolderContinueArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUsersOnFolderResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUsersCursorError'
      x-codegen-request-body-name: body
  /sharing/get_file_metadata/batch:
    post:
      summary: Sharing - Get File Metadata - Batch
      description: Returns shared file metadata.
      operationId: SharingGetFileMetadataBatch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetFileMetadataBatchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GetFileMetadataBatchResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharingUserError'
      x-codegen-request-body-name: body
  /paper/docs/users/remove:
    post:
      summary: Paper - Docs - Users - Remove
      description: >-
        Allows an owner or editor to remove users from a Paper doc using their
        email address or Dropbox account ID.


        Note: Doc owner cannot be removed.
      operationId: PaperDocsUsersRemove
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemovePaperDocUser'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /paper/docs/folder_users/list:
    post:
      summary: Paper - Docs - Folder Users - List
      description: >-
        Lists the users who are explicitly invited to the Paper folder in which
        the Paper doc is contained. For private folders all users (including
        owner) shared on the folder are listed and for team folders all non-team
        users shared on the folder are returned.
      operationId: PaperDocsFolderUsersList
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListUsersOnFolderArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUsersOnFolderResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /files/upload_session/append:
    post:
      summary: Files - Upload Session - Append
      description: >-
        Append more data to an upload session.

        A single request should not upload more than 150 MB. The maximum size of
        a file one can upload to an upload session is 350 GB.
      operationId: FilesUploadSessionAppend
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UploadSessionCursor'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadSessionLookupError'
      x-codegen-request-body-name: body
  /sharing/list_folders:
    post:
      summary: Sharing - List Folders
      description: |-
        Return the list of all shared folders the current user has access to.
        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingListFolders
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFoldersArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFoldersResult'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /files/get_metadata:
    post:
      summary: Files - Get Metadata
      description: |-
        Returns the metadata for a file or folder.
        Note: Metadata for the root folder is unsupported.
      operationId: FilesGetMetadata
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetMetadataArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Metadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMetadataError'
      x-codegen-request-body-name: body
  /sharing/list_file_members/batch:
    post:
      summary: Sharing - List File Members - Batch
      description: >-
        Get members of multiple files at once. The arguments to this route are
        more limited, and the limit on query result size per file is more
        strict. To customize the results more, use the individual file endpoint.

        Inherited users and groups are not included in the result, and
        permissions are not returned for this endpoint.
      operationId: SharingListFileMembersBatch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFileMembersBatchArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ListFileMembersBatchResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharingUserError'
      x-codegen-request-body-name: body
  /sharing/transfer_folder:
    post:
      summary: Sharing - Transfer Folder
      description: >-
        Transfer ownership of a shared folder to a member of the shared folder.

        User must have :field:`AccessLevel.owner` access to the shared folder to
        perform a transfer.

        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingTransferFolder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferFolderArg'
        required: false
      responses:
        '200':
          description: Success
          content: {}
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransferFolderError'
      x-codegen-request-body-name: body
  /file_properties/templates/get_for_user:
    post:
      summary: File Properties - Templates - Get For User
      description: >-
        Get the schema for a specified template. This endpoint can't be called
        on a team member or admin's behalf.
      operationId: FilePropertiesTemplatesGetForUser
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTemplateArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateError'
      x-codegen-request-body-name: body
  /files/list_revisions:
    post:
      summary: Files - List Revisions
      description: >-
        Returns revisions for files based on a file path or a file id. The file
        path or file id is identified from the latest file entry at the given
        file path or id. This end point allows your app to query either by file
        path or file id by setting the mode parameter appropriately.

        In the :field:`ListRevisionsMode.path` (default) mode, all revisions at
        the same file path as the latest file entry are returned. If revisions
        with the same file id are desired, then mode must be set to
        :field:`ListRevisionsMode.id`. The :field:`ListRevisionsMode.id` mode is
        useful to retrieve revisions for a given file across moves or renames.
      operationId: FilesListRevisions
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListRevisionsArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRevisionsResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRevisionsError'
      x-codegen-request-body-name: body
  /files/get_preview:
    post:
      summary: Files - Get Preview
      description: >-
        Get a preview for a file.

        Currently, PDF previews are generated for files with the following
        extensions: .ai, .doc, .docm, .docx, .eps, .odp, .odt, .pps, .ppsm,
        .ppsx, .ppt, .pptm, .pptx, .rtf.

        HTML previews are generated for files with the following extensions:
        .csv, .ods, .xls, .xlsm, .xlsx.

        Other formats will return an unsupported extension error.
      operationId: FilesGetPreview
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PreviewArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FileMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PreviewError'
      x-codegen-request-body-name: body
  /files/properties/template/list:
    post:
      summary: Files - Properties - Template - List
      operationId: FilesPropertiesTemplateList
      requestBody:
        content:
          application/json: {}
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListTemplateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateError'
      x-codegen-request-body-name: body
  /paper/docs/create:
    post:
      summary: Paper - Docs - Create
      description: Creates a new Paper doc with the provided content.
      operationId: PaperDocsCreate
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PaperDocCreateArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaperDocCreateUpdateResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaperDocCreateError'
      x-codegen-request-body-name: body
  /paper/docs/list:
    post:
      summary: Paper - Docs - List
      description: >-
        Return the list of all Paper docs according to the argument
        specifications. To iterate over through the full pagination, pass the
        cursor to :route:`docs/list/continue`.
      operationId: PaperDocsList
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListPaperDocsArgs'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPaperDocsResponse'
        default:
          description: Error
          content: {}
      x-codegen-request-body-name: body
  /sharing/get_shared_link_file:
    post:
      summary: Sharing - Get Shared Link File
      description: Download the shared link's file from a user's Dropbox.
      operationId: SharingGetSharedLinkFile
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetSharedLinkMetadataArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedLinkMetadata'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSharedLinkFileError'
      x-codegen-request-body-name: body
  /paper/docs/download:
    post:
      summary: Paper - Docs - Download
      description: Exports and downloads Paper doc either as HTML or markdown.
      operationId: PaperDocsDownload
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PaperDocExport'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaperDocExportResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocLookupError'
      x-codegen-request-body-name: body
  /files/delete_batch/check:
    post:
      summary: Files - Delete Batch - Check
      description: >-
        Returns the status of an asynchronous job for :route:`delete_batch`. If
        success, it returns list of result for each entry.
      operationId: FilesDeleteBatchCheck
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteBatchJobStatus'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollError'
      x-codegen-request-body-name: body
  /files/delete_v2:
    post:
      summary: Files - Delete V2
      description: >-
        Delete the file or folder at a given path.

        If the path is a folder, all its contents will be deleted too.

        A successful response indicates that the file or folder was deleted. The
        returned metadata will be the corresponding :type:`FileMetadata` or
        :type:`FolderMetadata` for the item at time of deletion, and not a
        :type:`DeletedMetadata` object.
      operationId: FilesDeleteV2
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteResult'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteError'
      x-codegen-request-body-name: body
  /sharing/check_job_status:
    post:
      summary: Sharing - Check Job Status
      description: |-
        Returns the status of an asynchronous job.
        Apps must have full Dropbox access to use this endpoint.
      operationId: SharingCheckJobStatus
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PollArg'
        required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatus'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollError'
      x-codegen-request-body-name: body
components:
  schemas:
    PreviewArg:
      type: object
      properties:
        path:
          type: string
          description: The path of the file to preview.
        rev:
          type: string
          description: Please specify revision in :field:`path` instead.
      description: |
        path: The path of the file to preview.
        rev: Please specify revision in :field:`path` instead.
    Metadata:
      type: object
      properties:
        parent_shared_folder_id:
          type: string
          description: >-
            Please use :field:`FileSharingInfo.parent_shared_folder_id` or
            :field:`FolderSharingInfo.parent_shared_folder_id` instead.
        name:
          type: string
          description: >-
            The last component of the path (including extension). This never
            contains a slash.
        path_display:
          type: string
          description: >-
            The cased path to be used for display purposes only. In rare
            instances the casing will not correctly match the user's filesystem,
            but this behavior will match the path provided in the Core API v1,
            and at least the last path component will have the correct casing.
            Changes to only the casing of paths won't be returned by
            :route:`list_folder/continue`. This field will be null if the file
            or folder is not mounted.
        path_lower:
          type: string
          description: >-
            The lowercased full path in the user's Dropbox. This always starts
            with a slash. This field will be null if the file or folder is not
            mounted.
      description: >
        Metadata for a file or folder.

        name: The last component of the path (including extension). This never
        contains a slash.

        path_lower: The lowercased full path in the user's Dropbox. This always
        starts with a slash. This field will be null if the file or folder is
        not mounted.

        path_display: The cased path to be used for display purposes only. In
        rare instances the casing will not correctly match the user's
        filesystem, but this behavior will match the path provided in the Core
        API v1, and at least the last path component will have the correct
        casing. Changes to only the casing of paths won't be returned by
        :route:`list_folder/continue`. This field will be null if the file or
        folder is not mounted.

        parent_shared_folder_id: Please use
        :field:`FileSharingInfo.parent_shared_folder_id` or
        :field:`FolderSharingInfo.parent_shared_folder_id` instead.
    ShareFolderArg:
      type: object
      properties:
        viewer_info_policy:
          $ref: '#/components/schemas/ViewerInfoPolicy'
        force_async:
          type: boolean
          description: Whether to force the share to happen asynchronously.
        acl_update_policy:
          $ref: '#/components/schemas/AclUpdatePolicy'
        actions:
          type: array
          description: >-
            A list of `FolderAction`s corresponding to `FolderPermission`s that
            should appear in the  response's
            :field:`SharedFolderMetadata.permissions` field describing the
            actions the  authenticated user can perform on the folder.
          items:
            $ref: '#/components/schemas/FolderAction'
        shared_link_policy:
          $ref: '#/components/schemas/SharedLinkPolicy'
        path:
          type: string
          description: >-
            The path to the folder to share. If it does not exist, then a new
            one is created.
        link_settings:
          $ref: '#/components/schemas/LinkSettings'
        member_policy:
          $ref: '#/components/schemas/MemberPolicy'
      description: >
        path: The path to the folder to share. If it does not exist, then a new
        one is created.

        acl_update_policy: Who can add and remove members of this shared folder.

        force_async: Whether to force the share to happen asynchronously.

        member_policy: Who can be a member of this shared folder. Only
        applicable if the current user is on a team.

        shared_link_policy: 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 :field:`SharedLinkPolicy.members`.

        viewer_info_policy: Who can enable/disable viewer info for this shared
        folder.

        actions: A list of `FolderAction`s corresponding to `FolderPermission`s
        that should appear in the  response's
        :field:`SharedFolderMetadata.permissions` field describing the actions
        the  authenticated user can perform on the folder.

        link_settings: Settings on the link for this folder.
    UpdateFolderPolicyArg:
      type: object
      properties:
        viewer_info_policy:
          $ref: '#/components/schemas/ViewerInfoPolicy'
        acl_update_policy:
          $ref: '#/components/schemas/AclUpdatePolicy'
        actions:
          type: array
          description: >-
            A list of `FolderAction`s corresponding to `FolderPermission`s that
            should appear in the  response's
            :field:`SharedFolderMetadata.permissions` field describing the
            actions the  authenticated user can perform on the folder.
          items:
            $ref: '#/components/schemas/FolderAction'
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
        shared_link_policy:
          $ref: '#/components/schemas/SharedLinkPolicy'
        link_settings:
          $ref: '#/components/schemas/LinkSettings'
        member_policy:
          $ref: '#/components/schemas/MemberPolicy'
      description: >
        If any of the policies are unset, then they retain their current
        setting.

        shared_folder_id: The ID for the shared folder.

        member_policy: Who can be a member of this shared folder. Only
        applicable if the current user is on a team.

        acl_update_policy: Who can add and remove members of this shared folder.

        viewer_info_policy: Who can enable/disable viewer info for this shared
        folder.

        shared_link_policy: 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 :field:`SharedLinkPolicy.members`.

        link_settings: Settings on the link for this folder.

        actions: A list of `FolderAction`s corresponding to `FolderPermission`s
        that should appear in the  response's
        :field:`SharedFolderMetadata.permissions` field describing the actions
        the  authenticated user can perform on the folder.
    LogicalOperator:
      type: object
      properties:
        .tag:
          title: Choice of LogicalOperator
          type: string
          enum:
            - or_operator
            - other
      description: |
        Logical operator to join search queries together.
        or_operator: Append a query with an "or" operator.
        other: None
    PropertyFieldTemplate:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/PropertyType'
        name:
          type: string
          description: >-
            Key of the property field being described. Property field keys can
            be up to 256 bytes.
        description:
          type: string
          description: >-
            Description of the property field. Property field descriptions can
            be up to 1024 bytes.
      description: >
        Defines how a single property field may be structured. Used exclusively
        by :type:`PropertyGroupTemplate`.

        name: Key of the property field being described. Property field keys can
        be up to 256 bytes.

        description: Description of the property field. Property field
        descriptions can be up to 1024 bytes.

        type: Data type of the value of this property field. This type will be
        enforced upon property creation and modifications.
    ModifySharedLinkSettingsArgs:
      type: object
      properties:
        url:
          type: string
          description: URL of the shared link to change its settings.
        remove_expiration:
          type: boolean
          description: If set to true, removes the expiration of the shared link.
        settings:
          $ref: '#/components/schemas/SharedLinkSettings'
      description: >
        url: URL of the shared link to change its settings.

        settings: Set of settings for the shared link.

        remove_expiration: If set to true, removes the expiration of the shared
        link.
    SharedLinkError:
      type: object
      properties:
        .tag:
          title: Choice of SharedLinkError
          type: string
          enum:
            - shared_link_not_found
            - shared_link_access_denied
            - unsupported_link_type
            - other
      description: >
        shared_link_not_found: The shared link wasn't found.

        shared_link_access_denied: The caller is not allowed to access this
        shared link.

        unsupported_link_type: This type of link is not supported.

        other: None
    UpdateTemplateArg:
      type: object
      properties:
        add_fields:
          type: array
          description: >-
            Property field templates to be added to the group template. There
            can be up to 32 properties in a single template.
          items:
            $ref: '#/components/schemas/PropertyFieldTemplate'
        description:
          type: string
          description: >-
            Description for the new template. Template descriptions can be up to
            1024 bytes.
        template_id:
          type: string
          description: >-
            An identifier for template added by  See
            :route:`templates/add_for_user` or :route:`templates/add_for_team`.
        name:
          type: string
          description: >-
            A display name for the template. template names can be up to 256
            bytes.
      description: >
        template_id: An identifier for template added by  See
        :route:`templates/add_for_user` or :route:`templates/add_for_team`.

        name: A display name for the template. template names can be up to 256
        bytes.

        description: Description for the new template. Template descriptions can
        be up to 1024 bytes.

        add_fields: Property field templates to be added to the group template.
        There can be up to 32 properties in a single template.
    UploadSessionStartResult:
      type: object
      properties:
        session_id:
          type: string
          description: >-
            A unique identifier for the upload session. Pass this to
            :route:`upload_session/append_v2` and
            :route:`upload_session/finish`.
      description: >
        session_id: A unique identifier for the upload session. Pass this to
        :route:`upload_session/append_v2` and :route:`upload_session/finish`.
    CreateFolderBatchError:
      type: object
      properties:
        .tag:
          title: Choice of CreateFolderBatchError
          type: string
          enum:
            - too_many_files
            - other
      description: |
        too_many_files: The operation would involve too many files or folders.
        other: None
    DeleteBatchResultData:
      type: object
      properties:
        metadata:
          $ref: '#/components/schemas/Metadata'
      description: |
        metadata: Metadata of the deleted object.
    FoldersContainingPaperDoc:
      type: object
      properties:
        folders:
          type: array
          description: The folder path. If present the first folder is the root folder.
          items:
            $ref: '#/components/schemas/Folder'
        folder_sharing_policy_type:
          $ref: '#/components/schemas/FolderSharingPolicyType'
      description: >
        Metadata about Paper folders containing the specififed Paper doc.

        folder_sharing_policy_type: The sharing policy of the folder containing
        the Paper doc.

        folders: The folder path. If present the first folder is the root
        folder.
    GetAccountBatchError:
      type: object
      properties:
        .tag:
          title: Choice of GetAccountBatchError
          type: string
          enum:
            - no_account
            - other
        no_account:
          type: string
          description: >-
            The value is an account ID specified in
            :field:`GetAccountBatchArg.account_ids` that does not exist.
      description: >
        no_account: The value is an account ID specified in
        :field:`GetAccountBatchArg.account_ids` that does not exist.

        other: None
    BasicAccount:
      type: object
      properties:
        account_id:
          type: string
          description: The user's unique Dropbox ID.
        is_teammate:
          type: boolean
          description: >-
            Whether this user is a teammate of the current user. If this account
            is the current user's account, then this will be :val:`true`.
        email_verified:
          type: boolean
          description: Whether the user has verified their e-mail address.
        team_member_id:
          type: string
          description: >-
            The user's unique team member id. This field will only be present if
            the user is part of a team and :field:`is_teammate` is :val:`true`.
        disabled:
          type: boolean
          description: Whether the user has been disabled.
        email:
          type: string
          description: >-
            The user's e-mail address. Do not rely on this without checking the
            :field:`email_verified` field. Even then, it's possible that the
            user has since lost access to their e-mail.
        profile_photo_url:
          type: string
          description: URL for the photo representing the user, if one is set.
        name:
          $ref: '#/components/schemas/Name'
      description: >
        Basic information about any account.

        account_id: The user's unique Dropbox ID.

        name: Details of a user's name.

        email: The user's e-mail address. Do not rely on this without checking
        the :field:`email_verified` field. Even then, it's possible that the
        user has since lost access to their e-mail.

        email_verified: Whether the user has verified their e-mail address.

        disabled: Whether the user has been disabled.

        is_teammate: Whether this user is a teammate of the current user. If
        this account is the current user's account, then this will be
        :val:`true`.

        profile_photo_url: URL for the photo representing the user, if one is
        set.

        team_member_id: The user's unique team member id. This field will only
        be present if the user is part of a team and :field:`is_teammate` is
        :val:`true`.
    DeleteBatchResult:
      type: object
      properties:
        entries:
          type: array
          items:
            $ref: '#/components/schemas/DeleteBatchResultEntry'
      description: |
        entries: None
    FolderPermission:
      type: object
      properties:
        action:
          $ref: '#/components/schemas/FolderAction'
        reason:
          $ref: '#/components/schemas/PermissionDeniedReason'
        allow:
          type: boolean
          description: True if the user is allowed to take the action.
      description: >
        Whether the user is allowed to take the action on the shared folder.

        action: The action that the user may wish to take on the folder.

        allow: True if the user is allowed to take the action.

        reason: The reason why the user is denied the permission. Not present if
        the action is allowed, or if no reason is available.
    UploadSessionFinishBatchResultEntry:
      type: object
      properties:
        failure:
          $ref: '#/components/schemas/UploadSessionFinishError'
        .tag:
          title: Choice of UploadSessionFinishBatchResultEntry
          type: string
          enum:
            - success
            - failure
        success:
          $ref: '#/components/schemas/FileMetadata'
      description: |
        success: None
        failure: None
    ExpectedSharedContentLinkMetadata:
      type: object
      properties:
        current_audience:
          $ref: '#/components/schemas/LinkAudience'
        password_protected:
          type: boolean
          description: Whether the link is protected by a password.
        expiry:
          type: string
          description: >-
            Whether the link has an expiry set on it. A link with an expiry will
            have its  audience changed to members when the expiry is reached.
        access_level:
          $ref: '#/components/schemas/AccessLevel'
        audience_restricting_shared_folder:
          $ref: '#/components/schemas/AudienceRestrictingSharedFolder'
        link_permissions:
          type: array
          description: A list of permissions for actions you can perform on the link.
          items:
            $ref: '#/components/schemas/LinkPermission'
        audience_options:
          type: array
          description: >-
            The audience options that are available for the content. Some
            audience options may be unavailable. For example, team_only may be
            unavailable if the content is not owned by a user on a team. The
            'default' audience option is always available if the user can modify
            link settings.
          items:
            $ref: '#/components/schemas/LinkAudience'
      description: >
        The expected metadata of a shared link for a file or folder when a link
        is first created for the content. Absent if the link already exists.

        audience_options: The audience options that are available for the
        content. Some audience options may be unavailable. For example,
        team_only may be unavailable if the content is not owned by a user on a
        team. The 'default' audience option is always available if the user can
        modify link settings.

        current_audience: The current audience of the link.

        link_permissions: A list of permissions for actions you can perform on
        the link.

        password_protected: Whether the link is protected by a password.

        access_level: The access level on the link for this file.

        audience_restricting_shared_folder: The shared folder that prevents the
        link audience for this link from being more restrictive.

        expiry: Whether the link has an expiry set on it. A link with an expiry
        will have its  audience changed to members when the expiry is reached.
    UploadSessionAppendArg:
      type: object
      properties:
        cursor:
          $ref: '#/components/schemas/UploadSessionCursor'
        close:
          type: boolean
          description: >-
            If true, the current session will be closed, at which point you
            won't be able to call :route:`upload_session/append_v2` anymore with
            the current session.
      description: >
        cursor: Contains the upload session ID and the offset.

        close: If true, the current session will be closed, at which point you
        won't be able to call :route:`upload_session/append_v2` anymore with the
        current session.
    ListUsersOnFolderArgs:
      type: object
      properties:
        limit:
          type: number
          description: >-
            Size limit per batch. The maximum number of users that can be
            retrieved per batch is 1000. Higher value results in invalid
            arguments error.
        doc_id:
          type: string
          description: The Paper doc ID.
      description: >
        doc_id: The Paper doc ID.

        limit: Size limit per batch. The maximum number of users that can be
        retrieved per batch is 1000. Higher value results in invalid arguments
        error.
    ListFileRequestsError:
      type: object
      properties:
        .tag:
          title: Choice of ListFileRequestsError
          type: string
          enum:
            - disabled_for_team
            - other
      description: >
        There was an error retrieving the file requests.

        disabled_for_team: This user's Dropbox Business team doesn't allow file
        requests.

        other: None
    LaunchResultBase:
      type: object
      properties:
        .tag:
          title: Choice of LaunchResultBase
          type: string
          enum:
            - async_job_id
        async_job_id:
          type: string
          description: >-
            This response indicates that the processing is asynchronous. The
            string is an id that can be used to obtain the status of the
            asynchronous job.
      description: >
        Result returned by methods that launch an asynchronous job.

        A method who may either launch an asynchronous job, or complete the
        request synchronously, can use this union by extending it, and adding a
        'complete' field with the type of the synchronous response.

        See :type:`LaunchEmptyResult` for an example.

        async_job_id: This response indicates that the processing is
        asynchronous. The string is an id that can be used to obtain the status
        of the asynchronous job.
    GetAccountBatchArg:
      type: object
      properties:
        account_ids:
          type: array
          description: >-
            List of user account identifiers.  Should not contain any duplicate
            account IDs.
          items:
            type: string
      description: >
        account_ids: List of user account identifiers.  Should not contain any
        duplicate account IDs.
    LookUpPropertiesError:
      type: object
      properties:
        .tag:
          title: Choice of LookUpPropertiesError
          type: string
          enum:
            - property_group_not_found
            - other
      description: |
        property_group_not_found: No property group was found.
        other: None
    RemovePaperDocUser:
      type: object
      properties:
        member:
          $ref: '#/components/schemas/MemberSelector'
        doc_id:
          type: string
          description: The Paper doc ID.
      description: >
        doc_id: The Paper doc ID.

        member: User which should be removed from the Paper doc. Specify only
        email address or Dropbox account ID.
    MountFolderArg:
      type: object
      properties:
        shared_folder_id:
          type: string
          description: The ID of the shared folder to mount.
      description: |
        shared_folder_id: The ID of the shared folder to mount.
    ListFoldersResult:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            Present if there are additional shared folders that have not been
            returned yet. Pass the cursor into the corresponding continue
            endpoint (either :route:`list_folders/continue` or
            :route:`list_mountable_folders/continue`) to list additional
            folders.
        entries:
          type: array
          description: List of all shared folders the authenticated user has access to.
          items:
            $ref: '#/components/schemas/SharedFolderMetadata'
      description: >
        Result for :route:`list_folders` or :route:`list_mountable_folders`,
        depending on which endpoint was requested.

        Unmounted shared folders can be identified by the absence of
        :field:`SharedFolderMetadata.path_lower`.

        entries: List of all shared folders the authenticated user has access
        to.

        cursor: Present if there are additional shared folders that have not
        been returned yet. Pass the cursor into the corresponding continue
        endpoint (either :route:`list_folders/continue` or
        :route:`list_mountable_folders/continue`) to list additional folders.
    PaperDocPermissionLevel:
      type: object
      properties:
        .tag:
          title: Choice of PaperDocPermissionLevel
          type: string
          enum:
            - edit
            - view_and_comment
            - other
      description: |
        edit: User will be granted edit permissions.
        view_and_comment: User will be granted view and comment permissions.
        other: None
    UnmountFolderArg:
      type: object
      properties:
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
      description: |
        shared_folder_id: The ID for the shared folder.
    GetSharedLinkMetadataArg:
      type: object
      properties:
        url:
          type: string
          description: URL of the shared link.
        path:
          type: string
          description: >-
            If the shared link is to a folder, this parameter can be used to
            retrieve the metadata for a specific file or sub-folder in this
            folder. A relative path should be used.
        link_password:
          type: string
          description: If the shared link has a password, this parameter can be used.
      description: >
        url: URL of the shared link.

        path: If the shared link is to a folder, this parameter can be used to
        retrieve the metadata for a specific file or sub-folder in this folder.
        A relative path should be used.

        link_password: If the shared link has a password, this parameter can be
        used.
    MemberSpaceLimitType:
      type: object
      properties:
        .tag:
          title: Choice of MemberSpaceLimitType
          type: string
          enum:
            - 'off'
            - alert_only
            - stop_sync
            - other
      description: >
        The type of the space limit imposed on a team member.

        off: The team member does not have imposed space limit.

        alert_only: The team member has soft imposed space limit - the limit is
        used for display and for notifications.

        stop_sync: The team member has hard imposed space limit - Dropbox file
        sync will stop after the limit is reached.

        other: None
    OverwritePropertyGroupArg:
      type: object
      properties:
        path:
          type: string
          description: A unique identifier for the file or folder.
        property_groups:
          type: array
          description: The property groups "snapshot" updates to force apply.
          items:
            $ref: '#/components/schemas/PropertyGroup'
      description: |
        path: A unique identifier for the file or folder.
        property_groups: The property groups "snapshot" updates to force apply.
    RemoveFileMemberArg:
      type: object
      properties:
        member:
          $ref: '#/components/schemas/MemberSelector'
        file:
          type: string
          description: File from which to remove members.
      description: >
        Arguments for :route:`remove_file_member_2`.

        file: File from which to remove members.

        member: Member to remove from this file. Note that even if an email is
        specified, it may result in the removal of a user (not an invitee) if
        the user's main account corresponds to that email address.
    CreateFolderEntryResult:
      type: object
      properties:
        metadata:
          $ref: '#/components/schemas/FolderMetadata'
      description: |
        metadata: Metadata of the created folder.
    DeleteResult:
      type: object
      properties:
        metadata:
          $ref: '#/components/schemas/Metadata'
      description: |
        metadata: Metadata of the deleted object.
    TransferFolderError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of TransferFolderError
          type: string
          enum:
            - access_error
            - invalid_dropbox_id
            - new_owner_not_a_member
            - new_owner_unmounted
            - new_owner_email_unverified
            - team_folder
            - no_permission
            - other
      description: >
        access_error: None

        invalid_dropbox_id: :field:`TransferFolderArg.to_dropbox_id` is invalid.

        new_owner_not_a_member: The new designated owner is not currently a
        member of the shared folder.

        new_owner_unmounted: The new designated owner has not added the folder
        to their Dropbox.

        new_owner_email_unverified: The new designated owner's e-mail address is
        unverified.

        team_folder: This action cannot be performed on a team shared folder.

        no_permission: The current user does not have permission to perform this
        action.

        other: None
    GetFileRequestArgs:
      type: object
      properties:
        id:
          type: string
          description: The ID of the file request to retrieve.
      description: |
        Arguments for :route:`get`.
        id: The ID of the file request to retrieve.
    ListFileMembersCountResult:
      type: object
      properties:
        member_count:
          type: number
          description: >-
            The number of members on this file. This does not include inherited
            members.
        members:
          $ref: '#/components/schemas/SharedFileMembers'
      description: >
        members: A list of members on this file.

        member_count: The number of members on this file. This does not include
        inherited members.
    ThumbnailError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of ThumbnailError
          type: string
          enum:
            - path
            - unsupported_extension
            - unsupported_image
            - conversion_error
      description: >
        path: An error occurs when downloading metadata for the image.

        unsupported_extension: The file extension doesn't allow conversion to a
        thumbnail.

        unsupported_image: The image cannot be converted to a thumbnail.

        conversion_error: An error occurs during thumbnail conversion.
    DownloadZipArg:
      type: object
      properties:
        path:
          type: string
          description: The path of the folder to download.
      description: |
        path: The path of the folder to download.
    SharedFolderMembers:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            Present if there are additional shared folder members that have not
            been returned yet. Pass the cursor into
            :route:`list_folder_members/continue` to list additional members.
        users:
          type: array
          description: The list of user members of the shared folder.
          items:
            $ref: '#/components/schemas/UserMembershipInfo'
        groups:
          type: array
          description: The list of group members of the shared folder.
          items:
            $ref: '#/components/schemas/GroupMembershipInfo'
        invitees:
          type: array
          description: The list of invitees to the shared folder.
          items:
            $ref: '#/components/schemas/InviteeMembershipInfo'
      description: >
        Shared folder user and group membership.

        users: The list of user members of the shared folder.

        groups: The list of group members of the shared folder.

        invitees: The list of invitees to the shared folder.

        cursor: Present if there are additional shared folder members that have
        not been returned yet. Pass the cursor into
        :route:`list_folder_members/continue` to list additional members.
    DownloadZipError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of DownloadZipError
          type: string
          enum:
            - path
            - too_large
            - too_many_files
            - other
      description: |
        path: None
        too_large: The folder is too large to download.
        too_many_files: The folder has too many files to download.
        other: None
    SharedLinkSettings:
      type: object
      properties:
        requested_visibility:
          $ref: '#/components/schemas/RequestedVisibility'
        link_password:
          type: string
          description: >-
            If :field:`requested_visibility` is
            :field:`RequestedVisibility.password` this is needed to specify the
            password to access the link.
        expires:
          type: string
          description: >-
            Expiration time of the shared link. By default the link won't
            expire.
      description: >
        requested_visibility: The requested access for this shared link.

        link_password: If :field:`requested_visibility` is
        :field:`RequestedVisibility.password` this is needed to specify the
        password to access the link.

        expires: Expiration time of the shared link. By default the link won't
        expire.
    RevokeSharedLinkArg:
      type: object
      properties:
        url:
          type: string
          description: URL of the shared link.
      description: |
        url: URL of the shared link.
    GetMetadataError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of GetMetadataError
          type: string
          enum:
            - path
      description: |
        path: None
    SharingPublicPolicyType:
      type: object
      properties:
        .tag:
          title: Choice of SharingPublicPolicyType
          type: string
          enum:
            - people_with_link_can_edit
            - people_with_link_can_view_and_comment
            - invite_only
            - disabled
      description: >
        people_with_link_can_edit: Users who have a link to this doc can edit
        it.

        people_with_link_can_view_and_comment: Users who have a link to this doc
        can view and comment on it.

        invite_only: Users must be explicitly invited to this doc.

        disabled: Value used to indicate that doc sharing is enabled only within
        team.
    UpdateFileRequestDeadline:
      type: object
      properties:
        .tag:
          title: Choice of UpdateFileRequestDeadline
          type: string
          enum:
            - no_update
            - update
            - other
        update:
          $ref: '#/components/schemas/FileRequestDeadline'
      description: |
        no_update: Do not change the file request's deadline.
        update: If :val:`null`, the file request's deadline is cleared.
        other: None
    UpdatePropertiesError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of UpdatePropertiesError
          type: string
          enum:
            - template_not_found
            - restricted_content
            - other
            - path
            - unsupported_folder
            - property_field_too_large
            - does_not_fit_template
            - property_group_lookup
        property_group_lookup:
          $ref: '#/components/schemas/LookUpPropertiesError'
        template_not_found:
          type: string
          description: Template does not exist for the given identifier.
      description: >
        template_not_found: Template does not exist for the given identifier.

        restricted_content: You do not have permission to modify this template.

        other: None

        path: None

        unsupported_folder: This folder cannot be tagged. Tagging folders is not
        supported for team-owned templates.

        property_field_too_large: One or more of the supplied property field
        values is too large.

        does_not_fit_template: One or more of the supplied property fields does
        not conform to the template specifications.

        property_group_lookup: None
    RemovePropertiesArg:
      type: object
      properties:
        path:
          type: string
          description: A unique identifier for the file or folder.
        property_template_ids:
          type: array
          description: >-
            A list of identifiers for a template created by
            :route:`templates/add_for_user` or :route:`templates/add_for_team`.
          items:
            type: string
      description: >
        path: A unique identifier for the file or folder.

        property_template_ids: A list of identifiers for a template created by
        :route:`templates/add_for_user` or :route:`templates/add_for_team`.
    UpdateFolderMemberArg:
      type: object
      properties:
        member:
          $ref: '#/components/schemas/MemberSelector'
        access_level:
          $ref: '#/components/schemas/AccessLevel'
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
      description: >
        shared_folder_id: The ID for the shared folder.

        member: The member of the shared folder to update.  Only the
        :field:`MemberSelector.dropbox_id` may be set at this time.

        access_level: The new access level for :field:`member`.
        :field:`AccessLevel.owner` is disallowed.
    CreateSharedLinkWithSettingsError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of CreateSharedLinkWithSettingsError
          type: string
          enum:
            - path
            - email_not_verified
            - shared_link_already_exists
            - settings_error
            - access_denied
        settings_error:
          $ref: '#/components/schemas/SharedLinkSettingsError'
      description: >
        path: None

        email_not_verified: User's email should be verified.

        shared_link_already_exists: The shared link already exists. You can call
        :route:`list_shared_links` to get the existing link.

        settings_error: There is an error with the given settings.

        access_denied: Access to the requested path is forbidden.
    SearchMode:
      type: object
      properties:
        .tag:
          title: Choice of SearchMode
          type: string
          enum:
            - filename
            - filename_and_content
            - deleted_filename
      description: >
        filename: Search file and folder names.

        filename_and_content: Search file and folder names as well as file
        contents.

        deleted_filename: Search for deleted file and folder names.
    SharedFileMetadata:
      type: object
      properties:
        owner_team:
          $ref: '#/components/schemas/Team'
        parent_shared_folder_id:
          type: string
          description: >-
            The ID of the parent shared folder. This field is present only if
            the file is contained within a shared folder.
        name:
          type: string
          description: The name of this file.
        time_invited:
          type: string
          description: >-
            Timestamp indicating when the current user was invited to this
            shared file. If the user was not invited to the shared file, the
            timestamp will indicate when the user was invited to the parent
            shared folder. This value may be absent.
        preview_url:
          type: string
          description: URL for displaying a web preview of the shared file.
        access_type:
          $ref: '#/components/schemas/AccessLevel'
        owner_display_names:
          type: array
          description: >-
            The display names of the users that own the file. If the file is
            part of a team folder, the display names of the team admins are also
            included. Absent if the owner display names cannot be fetched.
          items:
            type: string
        path_display:
          type: string
          description: >-
            The cased path to be used for display purposes only. In rare
            instances the casing will not correctly match the user's filesystem,
            but this behavior will match the path provided in the Core API v1.
            Absent for unmounted files.
        expected_link_metadata:
          $ref: '#/components/schemas/ExpectedSharedContentLinkMetadata'
        path_lower:
          type: string
          description: The lower-case full path of this file. Absent for unmounted files.
        policy:
          $ref: '#/components/schemas/FolderPolicy'
        permissions:
          type: array
          description: >-
            The sharing permissions that requesting user has on this file. This
            corresponds to the entries given in
            :field:`GetFileMetadataBatchArg.actions` or
            :field:`GetFileMetadataArg.actions`.
          items:
            $ref: '#/components/schemas/FilePermission'
        id:
          type: string
          description: The ID of the file.
        link_metadata:
          $ref: '#/components/schemas/SharedContentLinkMetadata'
      description: >
        Properties of the shared file.

        id: The ID of the file.

        name: The name of this file.

        policy: Policies governing this shared file.

        preview_url: URL for displaying a web preview of the shared file.

        access_type: The current user's access level for this shared file.

        expected_link_metadata: The expected metadata of the link associated for
        the file when it is first shared. Absent if the link already exists.
        This is for an unreleased feature so it may not be returned yet.

        link_metadata: The metadata of the link associated for the file. This is
        for an unreleased feature so it may not be returned yet.

        owner_display_names: The display names of the users that own the file.
        If the file is part of a team folder, the display names of the team
        admins are also included. Absent if the owner display names cannot be
        fetched.

        owner_team: The team that owns the file. This field is not present if
        the file is not owned by a team.

        parent_shared_folder_id: The ID of the parent shared folder. This field
        is present only if the file is contained within a shared folder.

        path_display: The cased path to be used for display purposes only. In
        rare instances the casing will not correctly match the user's
        filesystem, but this behavior will match the path provided in the Core
        API v1. Absent for unmounted files.

        path_lower: The lower-case full path of this file. Absent for unmounted
        files.

        permissions: The sharing permissions that requesting user has on this
        file. This corresponds to the entries given in
        :field:`GetFileMetadataBatchArg.actions` or
        :field:`GetFileMetadataArg.actions`.

        time_invited: Timestamp indicating when the current user was invited to
        this shared file. If the user was not invited to the shared file, the
        timestamp will indicate when the user was invited to the parent shared
        folder. This value may be absent.
    ThumbnailMode:
      type: object
      properties:
        .tag:
          title: Choice of ThumbnailMode
          type: string
          enum:
            - strict
            - bestfit
            - fitone_bestfit
      description: >
        strict: Scale down the image to fit within the given size.

        bestfit: Scale down the image to fit within the given size or its
        transpose.

        fitone_bestfit: Scale down the image to completely cover the given size
        or its transpose.
    AddFileMemberArgs:
      type: object
      properties:
        members:
          type: array
          description: >-
            Members to add. Note that even an email address is given, this may
            result in a user being directy added to the membership if that email
            is the user's main account email.
          items:
            $ref: '#/components/schemas/MemberSelector'
        quiet:
          type: boolean
          description: >-
            Whether added members should be notified via device notifications of
            their invitation.
        add_message_as_comment:
          type: boolean
          description: If the custom message should be added as a comment on the file.
        access_level:
          $ref: '#/components/schemas/AccessLevel'
        file:
          type: string
          description: File to which to add members.
        custom_message:
          type: string
          description: Message to send to added members in their invitation.
      description: >
        Arguments for :route:`add_file_member`.

        file: File to which to add members.

        members: Members to add. Note that even an email address is given, this
        may result in a user being directy added to the membership if that email
        is the user's main account email.

        custom_message: Message to send to added members in their invitation.

        quiet: Whether added members should be notified via device notifications
        of their invitation.

        access_level: AccessLevel union object, describing what access level we
        want to give new members.

        add_message_as_comment: If the custom message should be added as a
        comment on the file.
    ShareFolderJobStatus:
      type: object
      properties:
        failed:
          $ref: '#/components/schemas/ShareFolderError'
        .tag:
          title: Choice of ShareFolderJobStatus
          type: string
          enum:
            - in_progress
            - complete
            - failed
        complete:
          $ref: '#/components/schemas/SharedFolderMetadata'
      description: >
        in_progress: The asynchronous job is still in progress.

        complete: The share job has finished. The value is the metadata for the
        folder.

        failed: None
    RelocationPath:
      type: object
      properties:
        from_path:
          type: string
          description: Path in the user's Dropbox to be copied or moved.
        to_path:
          type: string
          description: Path in the user's Dropbox that is the destination.
      description: |
        from_path: Path in the user's Dropbox to be copied or moved.
        to_path: Path in the user's Dropbox that is the destination.
    SharedFolderJoinPolicy:
      type: object
      properties:
        .tag:
          title: Choice of SharedFolderJoinPolicy
          type: string
          enum:
            - from_team_only
            - from_anyone
            - other
      description: >
        Policy governing which shared folders a team member can join.

        from_team_only: Team members can only join folders shared by teammates.

        from_anyone: Team members can join any shared folder, including those
        shared by users outside the team.

        other: None
    IndividualSpaceAllocation:
      type: object
      properties:
        allocated:
          type: number
          description: The total space allocated to the user's account (bytes).
      description: |
        allocated: The total space allocated to the user's account (bytes).
    ListRevisionsArg:
      type: object
      properties:
        path:
          type: string
          description: The path to the file you want to see the revisions of.
        limit:
          type: number
          description: The maximum number of revision entries returned.
        mode:
          $ref: '#/components/schemas/ListRevisionsMode'
      description: >
        path: The path to the file you want to see the revisions of.

        mode: Determines the behavior of the API in listing the revisions for a
        given file path or id.

        limit: The maximum number of revision entries returned.
    CommitInfoWithProperties:
      type: object
      properties:
        autorename:
          type: boolean
          description: >-
            If there's a conflict, as determined by :field:`mode`, have the
            Dropbox server try to autorename the file to avoid conflict.
        mute:
          type: boolean
          description: >-
            Normally, users are made aware of any file modifications in their
            Dropbox account via notifications in the client software. If
            :val:`true`, this tells the clients that this modification shouldn't
            result in a user notification.
        client_modified:
          type: string
          description: >-
            The value to store as the :field:`client_modified` timestamp.
            Dropbox automatically records the time at which the file was written
            to the Dropbox servers. It can also record an additional timestamp,
            provided by Dropbox desktop clients, mobile clients, and API apps of
            when the file was actually created or modified.
        mode:
          $ref: '#/components/schemas/WriteMode'
        path:
          type: string
          description: Path in the user's Dropbox to save the file.
        property_groups:
          type: array
          description: List of custom properties to add to file.
          items:
            $ref: '#/components/schemas/PropertyGroup'
      description: >
        path: Path in the user's Dropbox to save the file.

        mode: Selects what to do if the file already exists.

        autorename: If there's a conflict, as determined by :field:`mode`, have
        the Dropbox server try to autorename the file to avoid conflict.

        client_modified: The value to store as the :field:`client_modified`
        timestamp. Dropbox automatically records the time at which the file was
        written to the Dropbox servers. It can also record an additional
        timestamp, provided by Dropbox desktop clients, mobile clients, and API
        apps of when the file was actually created or modified.

        mute: Normally, users are made aware of any file modifications in their
        Dropbox account via notifications in the client software. If
        :val:`true`, this tells the clients that this modification shouldn't
        result in a user notification.

        property_groups: List of custom properties to add to file.
    ListUsersOnPaperDocArgs:
      type: object
      properties:
        limit:
          type: number
          description: >-
            Size limit per batch. The maximum number of users that can be
            retrieved per batch is 1000. Higher value results in invalid
            arguments error.
        doc_id:
          type: string
          description: The Paper doc ID.
        filter_by:
          $ref: '#/components/schemas/UserOnPaperDocFilter'
      description: >
        doc_id: The Paper doc ID.

        limit: Size limit per batch. The maximum number of users that can be
        retrieved per batch is 1000. Higher value results in invalid arguments
        error.

        filter_by: Specify this attribute if you want to obtain users that have
        already accessed the Paper doc.
    ListFilesArg:
      type: object
      properties:
        limit:
          type: number
          description: >-
            Number of files to return max per query. Defaults to 100 if no limit
            is specified.
        actions:
          type: array
          description: >-
            A list of `FileAction`s corresponding to `FilePermission`s that
            should appear in the  response's
            :field:`SharedFileMetadata.permissions` field describing the actions
            the  authenticated user can perform on the file.
          items:
            $ref: '#/components/schemas/FileAction'
      description: >
        Arguments for :route:`list_received_files`.

        limit: Number of files to return max per query. Defaults to 100 if no
        limit is specified.

        actions: A list of `FileAction`s corresponding to `FilePermission`s that
        should appear in the  response's :field:`SharedFileMetadata.permissions`
        field describing the actions the  authenticated user can perform on the
        file.
    ListFoldersContinueArg:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            The cursor returned by the previous API call specified in the
            endpoint description.
      description: >
        cursor: The cursor returned by the previous API call specified in the
        endpoint description.
    ListPaperDocsSortBy:
      type: object
      properties:
        .tag:
          title: Choice of ListPaperDocsSortBy
          type: string
          enum:
            - accessed
            - modified
            - created
            - other
      description: |
        accessed: Sorts the Paper docs by the time they were last accessed.
        modified: Sorts the Paper docs by the time they were last modified.
        created: Sorts the Paper docs by the creation time.
        other: None
    FolderPolicy:
      type: object
      properties:
        viewer_info_policy:
          $ref: '#/components/schemas/ViewerInfoPolicy'
        resolved_member_policy:
          $ref: '#/components/schemas/MemberPolicy'
        acl_update_policy:
          $ref: '#/components/schemas/AclUpdatePolicy'
        shared_link_policy:
          $ref: '#/components/schemas/SharedLinkPolicy'
        member_policy:
          $ref: '#/components/schemas/MemberPolicy'
      description: >
        A set of policies governing membership and privileges for a shared
        folder.

        acl_update_policy: Who can add and remove members from this shared
        folder.

        shared_link_policy: Who links can be shared with.

        member_policy: Who can be a member of this shared folder, as set on the
        folder itself. The effective policy may differ from this value if the
        team-wide policy is more restrictive. Present only if the folder is
        owned by a team.

        resolved_member_policy: Who can be a member of this shared folder,
        taking into account both the folder and the team-wide policy. This value
        may differ from that of member_policy if the team-wide policy is more
        restrictive than the folder policy. Present only if the folder is owned
        by a team.

        viewer_info_policy: Who can enable/disable viewer info for this shared
        folder.
    GetCopyReferenceArg:
      type: object
      properties:
        path:
          type: string
          description: The path to the file or folder you want to get a copy reference to.
      description: >
        path: The path to the file or folder you want to get a copy reference
        to.
    CreateFolderBatchArg:
      type: object
      properties:
        paths:
          type: array
          description: >-
            List of paths to be created in the user's Dropbox. Duplicate path
            arguments in the batch are considered only once.
          items:
            type: string
        force_async:
          type: boolean
          description: Whether to force the create to happen asynchronously.
        autorename:
          type: boolean
          description: >-
            If there's a conflict, have the Dropbox server try to autorename the
            folder to avoid the conflict.
      description: >
        paths: List of paths to be created in the user's Dropbox. Duplicate path
        arguments in the batch are considered only once.

        autorename: If there's a conflict, have the Dropbox server try to
        autorename the folder to avoid the conflict.

        force_async: Whether to force the create to happen asynchronously.
    SharedLinkSettingsError:
      type: object
      properties:
        .tag:
          title: Choice of SharedLinkSettingsError
          type: string
          enum:
            - invalid_settings
            - not_authorized
      description: >
        invalid_settings: The given settings are invalid (for example, all
        attributes of the :type:`SharedLinkSettings` are empty, the requested
        visibility is :field:`RequestedVisibility.password` but the
        :field:`SharedLinkSettings.link_password` is missing,
        :field:`SharedLinkSettings.expires` is set to the past, etc.).

        not_authorized: User is not allowed to modify the settings of this link.
        Note that basic users can only set :field:`RequestedVisibility.public`
        as the :field:`SharedLinkSettings.requested_visibility` and cannot set
        :field:`SharedLinkSettings.expires`.
    TeamMemberInfo:
      type: object
      properties:
        member_id:
          type: string
          description: >-
            ID of user as a member of a team. This field will only be present if
            the member is in the same team as current user.
        display_name:
          type: string
          description: The display name of the user.
        team_info:
          $ref: '#/components/schemas/Team'
      description: >
        Information about a team member.

        team_info: Information about the member's team.

        display_name: The display name of the user.

        member_id: ID of user as a member of a team. This field will only be
        present if the member is in the same team as current user.
    SaveCopyReferenceError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/WriteError'
        .tag:
          title: Choice of SaveCopyReferenceError
          type: string
          enum:
            - path
            - invalid_copy_reference
            - no_permission
            - not_found
            - too_many_files
            - other
      description: >
        path: None

        invalid_copy_reference: The copy reference is invalid.

        no_permission: You don't have permission to save the given copy
        reference. Please make sure this app is same app which created the copy
        reference and the source user is still linked to the app.

        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: None
    ListFoldersArgs:
      type: object
      properties:
        limit:
          type: number
          description: The maximum number of results to return per request.
        actions:
          type: array
          description: >-
            A list of `FolderAction`s corresponding to `FolderPermission`s that
            should appear in the  response's
            :field:`SharedFolderMetadata.permissions` field describing the
            actions the  authenticated user can perform on the folder.
          items:
            $ref: '#/components/schemas/FolderAction'
      description: >
        limit: The maximum number of results to return per request.

        actions: A list of `FolderAction`s corresponding to `FolderPermission`s
        that should appear in the  response's
        :field:`SharedFolderMetadata.permissions` field describing the actions
        the  authenticated user can perform on the folder.
    FileMemberRemoveActionResult:
      type: object
      properties:
        member_error:
          $ref: '#/components/schemas/FileMemberActionError'
        .tag:
          title: Choice of FileMemberRemoveActionResult
          type: string
          enum:
            - success
            - member_error
            - other
        success:
          $ref: '#/components/schemas/MemberAccessLevelResult'
      description: |
        success: Member was successfully removed from this file.
        member_error: User was not able to remove this member.
        other: None
    SharedLinkPolicy:
      type: object
      properties:
        .tag:
          title: Choice of SharedLinkPolicy
          type: string
          enum:
            - anyone
            - team
            - members
            - other
      description: |
        Who can view shared links in this folder.
        anyone: Links can be shared with anyone.
        team: Links can be shared with anyone on the same team as the owner.
        members: Links can only be shared among members of the shared folder.
        other: None
    ListFileMembersBatchResult:
      type: object
      properties:
        result:
          $ref: '#/components/schemas/ListFileMembersIndividualResult'
        file:
          type: string
          description: This is the input file identifier, whether an ID or a path.
      description: |
        Per-file result for :route:`list_file_members/batch`.
        file: This is the input file identifier, whether an ID or a path.
        result: The result for this particular file.
    AudienceExceptionContentInfo:
      type: object
      properties:
        name:
          type: string
          description: The name of the content, which is either a file or a folder.
      description: >
        Information about the content that has a link audience different than
        that of this folder.

        name: The name of the content, which is either a file or a folder.
    ListUsersOnFolderResponse:
      type: object
      properties:
        cursor:
          $ref: '#/components/schemas/Cursor'
        has_more:
          type: boolean
          description: >-
            Will be set to True if a subsequent call with the provided cursor to
            :route:`docs/folder_users/list/continue` returns immediately with
            some results. If set to False please allow some delay before making
            another call to :route:`docs/folder_users/list/continue`.
        users:
          type: array
          description: List of users that are invited on the Paper folder.
          items:
            $ref: '#/components/schemas/UserInfo'
        invitees:
          type: array
          description: List of email addresses that are invited on the Paper folder.
          items:
            $ref: '#/components/schemas/InviteeInfo'
      description: >
        invitees: List of email addresses that are invited on the Paper folder.

        users: List of users that are invited on the Paper folder.

        cursor: Pass the cursor into :route:`docs/folder_users/list/continue` to
        paginate through all users. The cursor preserves all properties as
        specified in the original call to :route:`docs/folder_users/list`.

        has_more: Will be set to True if a subsequent call with the provided
        cursor to :route:`docs/folder_users/list/continue` returns immediately
        with some results. If set to False please allow some delay before making
        another call to :route:`docs/folder_users/list/continue`.
    MountFolderError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        insufficient_quota:
          $ref: '#/components/schemas/InsufficientQuotaAmounts'
        .tag:
          title: Choice of MountFolderError
          type: string
          enum:
            - access_error
            - inside_shared_folder
            - insufficient_quota
            - already_mounted
            - no_permission
            - not_mountable
            - other
      description: >
        access_error: None

        inside_shared_folder: Mounting would cause a shared folder to be inside
        another, which is disallowed.

        insufficient_quota: The current user does not have enough space to mount
        the shared folder.

        already_mounted: The shared folder is already mounted.

        no_permission: The current user does not have permission to perform this
        action.

        not_mountable: The shared folder is not mountable. One example where
        this can occur is when the shared folder belongs within a team folder in
        the user's Dropbox.

        other: None
    GetSharedLinkFileError:
      type: object
      properties:
        .tag:
          title: Choice of GetSharedLinkFileError
          type: string
          enum:
            - shared_link_not_found
            - shared_link_access_denied
            - unsupported_link_type
            - other
            - shared_link_is_directory
      description: >
        shared_link_not_found: The shared link wasn't found.

        shared_link_access_denied: The caller is not allowed to access this
        shared link.

        unsupported_link_type: This type of link is not supported.

        other: None

        shared_link_is_directory: Directories cannot be retrieved by this
        endpoint.
    DownloadError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of DownloadError
          type: string
          enum:
            - path
            - other
      description: |
        path: None
        other: None
    RefPaperDoc:
      type: object
      properties:
        doc_id:
          type: string
          description: The Paper doc ID.
      description: |
        doc_id: The Paper doc ID.
    CommitInfo:
      type: object
      properties:
        autorename:
          type: boolean
          description: >-
            If there's a conflict, as determined by :field:`mode`, have the
            Dropbox server try to autorename the file to avoid conflict.
        mute:
          type: boolean
          description: >-
            Normally, users are made aware of any file modifications in their
            Dropbox account via notifications in the client software. If
            :val:`true`, this tells the clients that this modification shouldn't
            result in a user notification.
        client_modified:
          type: string
          description: >-
            The value to store as the :field:`client_modified` timestamp.
            Dropbox automatically records the time at which the file was written
            to the Dropbox servers. It can also record an additional timestamp,
            provided by Dropbox desktop clients, mobile clients, and API apps of
            when the file was actually created or modified.
        mode:
          $ref: '#/components/schemas/WriteMode'
        path:
          type: string
          description: Path in the user's Dropbox to save the file.
        property_groups:
          type: array
          description: List of custom properties to add to file.
          items:
            $ref: '#/components/schemas/PropertyGroup'
      description: >
        path: Path in the user's Dropbox to save the file.

        mode: Selects what to do if the file already exists.

        autorename: If there's a conflict, as determined by :field:`mode`, have
        the Dropbox server try to autorename the file to avoid conflict.

        client_modified: The value to store as the :field:`client_modified`
        timestamp. Dropbox automatically records the time at which the file was
        written to the Dropbox servers. It can also record an additional
        timestamp, provided by Dropbox desktop clients, mobile clients, and API
        apps of when the file was actually created or modified.

        mute: Normally, users are made aware of any file modifications in their
        Dropbox account via notifications in the client software. If
        :val:`true`, this tells the clients that this modification shouldn't
        result in a user notification.

        property_groups: List of custom properties to add to file.
    UserMembershipInfo:
      type: object
      properties:
        initials:
          type: string
          description: Never set.
        permissions:
          type: array
          description: >-
            The permissions that requesting user has on this member. The set of
            permissions corresponds to the MemberActions in the request.
          items:
            $ref: '#/components/schemas/MemberPermission'
        user:
          $ref: '#/components/schemas/UserInfo'
        access_type:
          $ref: '#/components/schemas/AccessLevel'
        is_inherited:
          type: boolean
          description: True if the member has access from a parent folder.
      description: >
        The information about a user member of the shared content.

        access_type: The access type for this member.

        user: The account information for the membership user.

        permissions: The permissions that requesting user has on this member.
        The set of permissions corresponds to the MemberActions in the request.

        initials: Never set.

        is_inherited: True if the member has access from a parent folder.
    SpaceAllocation:
      type: object
      properties:
        .tag:
          title: Choice of SpaceAllocation
          type: string
          enum:
            - individual
            - team
            - other
        individual:
          $ref: '#/components/schemas/IndividualSpaceAllocation'
        team:
          $ref: '#/components/schemas/TeamSpaceAllocation'
      description: >
        Space is allocated differently based on the type of account.

        individual: The user's space allocation applies only to their individual
        account.

        team: The user shares space with other members of their team.

        other: None
    PaperDocSharingPolicy:
      type: object
      properties:
        doc_id:
          type: string
          description: The Paper doc ID.
        sharing_policy:
          $ref: '#/components/schemas/SharingPolicy'
      description: |
        doc_id: The Paper doc ID.
        sharing_policy: The default sharing policy to be set for the Paper doc.
    InsufficientQuotaAmounts:
      type: object
      properties:
        space_shortage:
          type: number
          description: The amount of extra space needed to add the item.
        space_left:
          type: number
          description: >-
            The amount of space left in the user's Dropbox, less than
            space_needed.
        space_needed:
          type: number
          description: The amount of space needed to add the item (the size of the item).
      description: >
        space_needed: The amount of space needed to add the item (the size of
        the item).

        space_shortage: The amount of extra space needed to add the item.

        space_left: The amount of space left in the user's Dropbox, less than
        space_needed.
    AccountType:
      type: object
      properties:
        .tag:
          title: Choice of AccountType
          type: string
          enum:
            - basic
            - pro
            - business
      description: |
        What type of account this user has.
        basic: The basic account type.
        pro: The Dropbox Pro account type.
        business: The Dropbox Business account type.
    GpsCoordinates:
      type: object
      properties:
        latitude:
          type: number
          description: Latitude of the GPS coordinates.
        longitude:
          type: number
          description: Longitude of the GPS coordinates.
      description: |
        GPS coordinates for a photo or video.
        latitude: Latitude of the GPS coordinates.
        longitude: Longitude of the GPS coordinates.
    FullTeam:
      type: object
      properties:
        sharing_policies:
          $ref: '#/components/schemas/TeamSharingPolicies'
        office_addin_policy:
          $ref: '#/components/schemas/OfficeAddInPolicy'
        id:
          type: string
          description: The team's unique ID.
        name:
          type: string
          description: The name of the team.
      description: |
        Detailed information about a team.
        id: The team's unique ID.
        name: The name of the team.
        sharing_policies: Team policies governing sharing.
        office_addin_policy: Team policy governing the use of the Office Add-In.
    ListFolderMembersContinueArg:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            The cursor returned by your last call to
            :route:`list_folder_members` or
            :route:`list_folder_members/continue`.
      description: >
        cursor: The cursor returned by your last call to
        :route:`list_folder_members` or :route:`list_folder_members/continue`.
    ListUsersOnPaperDocContinueArgs:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            The cursor obtained from :route:`docs/users/list` or
            :route:`docs/users/list/continue`. Allows for pagination.
        doc_id:
          type: string
          description: The Paper doc ID.
      description: >
        doc_id: The Paper doc ID.

        cursor: The cursor obtained from :route:`docs/users/list` or
        :route:`docs/users/list/continue`. Allows for pagination.
    ListFilesContinueError:
      type: object
      properties:
        .tag:
          title: Choice of ListFilesContinueError
          type: string
          enum:
            - user_error
            - invalid_cursor
            - other
        user_error:
          $ref: '#/components/schemas/SharingUserError'
      description: |
        Error results for :route:`list_received_files/continue`.
        user_error: User account had a problem.
        invalid_cursor: :field:`ListFilesContinueArg.cursor` is invalid.
        other: None
    ListFolderContinueArg:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            The cursor returned by your last call to :route:`list_folder` or
            :route:`list_folder/continue`.
      description: >
        cursor: The cursor returned by your last call to :route:`list_folder` or
        :route:`list_folder/continue`.
    InviteeInfo:
      type: object
      properties:
        .tag:
          title: Choice of InviteeInfo
          type: string
          enum:
            - email
            - other
        email:
          type: string
          description: E-mail address of invited user.
      description: |
        Information about the recipient of a shared content invitation.
        email: E-mail address of invited user.
        other: None
    RemoveMemberJobStatus:
      type: object
      properties:
        failed:
          $ref: '#/components/schemas/RemoveFolderMemberError'
        .tag:
          title: Choice of RemoveMemberJobStatus
          type: string
          enum:
            - in_progress
            - complete
            - failed
        complete:
          $ref: '#/components/schemas/MemberAccessLevelResult'
      description: >
        in_progress: The asynchronous job is still in progress.

        complete: Removing the folder member has finished. The value is
        information about whether the member has another form of access.

        failed: None
    TeamSpaceAllocation:
      type: object
      properties:
        allocated:
          type: number
          description: The total space allocated to the user's team (bytes).
        used:
          type: number
          description: The total space currently used by the user's team (bytes).
        user_within_team_space_limit_type:
          $ref: '#/components/schemas/MemberSpaceLimitType'
        user_within_team_space_allocated:
          type: number
          description: >-
            The total space allocated to the user within its team allocated
            space (0 means that no restriction is imposed on the user's quota
            within its team).
      description: >
        used: The total space currently used by the user's team (bytes).

        allocated: The total space allocated to the user's team (bytes).

        user_within_team_space_allocated: The total space allocated to the user
        within its team allocated space (0 means that no restriction is imposed
        on the user's quota within its team).

        user_within_team_space_limit_type: The type of the space limit imposed
        on the team member (off, alert_only, stop_sync).
    FolderSharingInfo:
      type: object
      properties:
        read_only:
          type: boolean
          description: True if the file or folder is inside a read-only shared folder.
        parent_shared_folder_id:
          type: string
          description: Set if the folder is contained by a shared folder.
        traverse_only:
          type: boolean
          description: >-
            Specifies that the folder can only be traversed and the user can
            only see a limited subset of the contents of this folder because
            they don't have read access to this folder. They do, however, have
            access to some sub folder.
        shared_folder_id:
          type: string
          description: >-
            If this folder is a shared folder mount point, the ID of the shared
            folder mounted at this location.
        no_access:
          type: boolean
          description: Specifies that the folder cannot be accessed by the user.
      description: >
        Sharing info for a folder which is contained in a shared folder or is a
        shared folder mount point.

        read_only: True if the file or folder is inside a read-only shared
        folder.

        parent_shared_folder_id: Set if the folder is contained by a shared
        folder.

        shared_folder_id: If this folder is a shared folder mount point, the ID
        of the shared folder mounted at this location.

        traverse_only: Specifies that the folder can only be traversed and the
        user can only see a limited subset of the contents of this folder
        because they don't have read access to this folder. They do, however,
        have access to some sub folder.

        no_access: Specifies that the folder cannot be accessed by the user.
    ListFileMembersArg:
      type: object
      properties:
        include_inherited:
          type: boolean
          description: >-
            Whether to include members who only have access from a parent shared
            folder.
        limit:
          type: number
          description: >-
            Number of members to return max per query. Defaults to 100 if no
            limit is specified.
        actions:
          type: array
          description: The actions for which to return permissions on a member.
          items:
            $ref: '#/components/schemas/MemberAction'
        file:
          type: string
          description: The file for which you want to see members.
      description: >
        Arguments for :route:`list_file_members`.

        file: The file for which you want to see members.

        actions: The actions for which to return permissions on a member.

        include_inherited: Whether to include members who only have access from
        a parent shared folder.

        limit: Number of members to return max per query. Defaults to 100 if no
        limit is specified.
    RemovePropertiesError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of RemovePropertiesError
          type: string
          enum:
            - template_not_found
            - restricted_content
            - other
            - path
            - unsupported_folder
            - property_group_lookup
        property_group_lookup:
          $ref: '#/components/schemas/LookUpPropertiesError'
        template_not_found:
          type: string
          description: Template does not exist for the given identifier.
      description: >
        template_not_found: Template does not exist for the given identifier.

        restricted_content: You do not have permission to modify this template.

        other: None

        path: None

        unsupported_folder: This folder cannot be tagged. Tagging folders is not
        supported for team-owned templates.

        property_group_lookup: None
    LinkSettings:
      type: object
      properties:
        access_level:
          $ref: '#/components/schemas/AccessLevel'
        audience:
          $ref: '#/components/schemas/LinkAudience'
        password:
          $ref: '#/components/schemas/LinkPassword'
        expiry:
          $ref: '#/components/schemas/LinkExpiry'
      description: >
        Settings that apply to a link.

        access_level: The access level on the link for this file. Currently, it
        only accepts 'viewer' and 'viewer_no_comment'.

        audience: The type of audience on the link for this file.

        expiry: An expiry timestamp to set on a link.

        password: The password for the link.
    GetTemporaryLinkResult:
      type: object
      properties:
        link:
          type: string
          description: The temporary link which can be used to stream content the file.
        metadata:
          $ref: '#/components/schemas/FileMetadata'
      description: |
        metadata: Metadata of the file.
        link: The temporary link which can be used to stream content the file.
    ListPaperDocsContinueArgs:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            The cursor obtained from :route:`docs/list` or
            :route:`docs/list/continue`. Allows for pagination.
      description: >
        cursor: The cursor obtained from :route:`docs/list` or
        :route:`docs/list/continue`. Allows for pagination.
    TeamSharingPolicies:
      type: object
      properties:
        shared_folder_join_policy:
          $ref: '#/components/schemas/SharedFolderJoinPolicy'
        shared_folder_member_policy:
          $ref: '#/components/schemas/SharedFolderMemberPolicy'
        shared_link_create_policy:
          $ref: '#/components/schemas/SharedLinkCreatePolicy'
      description: >
        Policies governing sharing within and outside of the team.

        shared_folder_member_policy: Who can join folders shared by team
        members.

        shared_folder_join_policy: Which shared folders team members can join.

        shared_link_create_policy: Who can view shared links owned by team
        members.
    FolderAction:
      type: object
      properties:
        .tag:
          title: Choice of FolderAction
          type: string
          enum:
            - change_options
            - disable_viewer_info
            - edit_contents
            - enable_viewer_info
            - invite_editor
            - invite_viewer
            - invite_viewer_no_comment
            - relinquish_membership
            - unmount
            - unshare
            - leave_a_copy
            - share_link
            - create_link
            - set_access_inheritance
            - other
      description: >
        Actions that may be taken on shared folders.

        change_options: Change folder options, such as who can be invited to
        join the folder.

        disable_viewer_info: Disable viewer information for this folder.

        edit_contents: Change or edit contents of the folder.

        enable_viewer_info: Enable viewer information on the folder.

        invite_editor: Invite a user or group to join the folder with read and
        write permission.

        invite_viewer: Invite a user or group to join the folder with read
        permission.

        invite_viewer_no_comment: Invite a user or group to join the folder with
        read permission but no comment permissions.

        relinquish_membership: Relinquish one's own membership in the folder.

        unmount: Unmount the folder.

        unshare: Stop sharing this folder.

        leave_a_copy: Keep a copy of the contents upon leaving or being kicked
        from the folder.

        share_link: Use create_link instead.

        create_link: Create a shared link for folder.

        set_access_inheritance: Set whether the folder inherits permissions from
        its parent.

        other: None
    RequestedVisibility:
      type: object
      properties:
        .tag:
          title: Choice of RequestedVisibility
          type: string
          enum:
            - public
            - team_only
            - password
      description: >
        The access permission that can be requested by the caller for the shared
        link. Note that the final resolved visibility of the shared link takes
        into account other aspects, such as team and shared folder settings.
        Check the :type:`ResolvedVisibility` for more info on the possible
        resolved visibility values of shared links.

        public: Anyone who has received the link can access it. No login
        required.

        team_only: Only members of the same team can access the link. Login is
        required.

        password: A link-specific password is required to access the link. Login
        is not required.
    RelocationResult:
      type: object
      properties:
        metadata:
          $ref: '#/components/schemas/Metadata'
      description: |
        metadata: Metadata of the relocated object.
    ViewerInfoPolicy:
      type: object
      properties:
        .tag:
          title: Choice of ViewerInfoPolicy
          type: string
          enum:
            - enabled
            - disabled
            - other
      description: |
        enabled: Viewer information is available on this file.
        disabled: Viewer information is disabled on this file.
        other: None
    PaperDocExport:
      type: object
      properties:
        export_format:
          $ref: '#/components/schemas/ExportFormat'
        doc_id:
          type: string
          description: The Paper doc ID.
      description: |
        doc_id: The Paper doc ID.
        export_format: None
    ShareFolderLaunch:
      type: object
      properties:
        .tag:
          title: Choice of ShareFolderLaunch
          type: string
          enum:
            - async_job_id
            - complete
        async_job_id:
          type: string
          description: >-
            This response indicates that the processing is asynchronous. The
            string is an id that can be used to obtain the status of the
            asynchronous job.
        complete:
          $ref: '#/components/schemas/SharedFolderMetadata'
      description: >
        async_job_id: This response indicates that the processing is
        asynchronous. The string is an id that can be used to obtain the status
        of the asynchronous job.

        complete: None
    ListPaperDocsArgs:
      type: object
      properties:
        sort_by:
          $ref: '#/components/schemas/ListPaperDocsSortBy'
        sort_order:
          $ref: '#/components/schemas/ListPaperDocsSortOrder'
        limit:
          type: number
          description: >-
            Size limit per batch. The maximum number of docs that can be
            retrieved per batch is 1000. Higher value results in invalid
            arguments error.
        filter_by:
          $ref: '#/components/schemas/ListPaperDocsFilterBy'
      description: >
        filter_by: Allows user to specify how the Paper docs should be filtered.

        sort_by: Allows user to specify how the Paper docs should be sorted.

        sort_order: Allows user to specify the sort order of the result.

        limit: Size limit per batch. The maximum number of docs that can be
        retrieved per batch is 1000. Higher value results in invalid arguments
        error.
    GetThumbnailBatchResultEntry:
      type: object
      properties:
        failure:
          $ref: '#/components/schemas/ThumbnailError'
        .tag:
          title: Choice of GetThumbnailBatchResultEntry
          type: string
          enum:
            - success
            - failure
            - other
        success:
          $ref: '#/components/schemas/GetThumbnailBatchResultData'
      description: |
        success: None
        failure: The result for this file if it was an error.
        other: None
    UploadSessionLookupError:
      type: object
      properties:
        .tag:
          title: Choice of UploadSessionLookupError
          type: string
          enum:
            - not_found
            - incorrect_offset
            - closed
            - not_closed
            - too_large
            - other
        incorrect_offset:
          $ref: '#/components/schemas/UploadSessionOffsetError'
      description: >
        not_found: The upload session ID was not found or has expired. Upload
        sessions are valid for 48 hours.

        incorrect_offset: The specified offset was incorrect. See the value for
        the correct offset. This error may occur when a previous request was
        received and processed successfully but the client did not receive the
        response, e.g. due to a network error.

        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.

        too_large: You can not append to the upload session because the size of
        a file should not reach the max file size limit (i.e. 350GB).

        other: None
    ListPaperDocsSortOrder:
      type: object
      properties:
        .tag:
          title: Choice of ListPaperDocsSortOrder
          type: string
          enum:
            - ascending
            - descending
            - other
      description: |
        ascending: Sorts the search result in ascending order.
        descending: Sorts the search result in descending order.
        other: None
    SaveUrlArg:
      type: object
      properties:
        url:
          type: string
          description: The URL to be saved.
        path:
          type: string
          description: The path in Dropbox where the URL will be saved to.
      description: |
        path: The path in Dropbox where the URL will be saved to.
        url: The URL to be saved.
    SearchResult:
      type: object
      properties:
        matches:
          type: array
          description: A list (possibly empty) of matches for the query.
          items:
            $ref: '#/components/schemas/SearchMatch'
        start:
          type: number
          description: >-
            Used for paging. Value to set the start argument to when calling
            :route:`search` to fetch the next page of results.
        more:
          type: boolean
          description: >-
            Used for paging. If true, indicates there is another page of results
            available that can be fetched by calling :route:`search` again.
      description: >
        matches: A list (possibly empty) of matches for the query.

        more: Used for paging. If true, indicates there is another page of
        results available that can be fetched by calling :route:`search` again.

        start: Used for paging. Value to set the start argument to when calling
        :route:`search` to fetch the next page of results.
    AddPaperDocUserResult:
      type: object
      properties:
        .tag:
          title: Choice of AddPaperDocUserResult
          type: string
          enum:
            - success
            - unknown_error
            - sharing_outside_team_disabled
            - daily_limit_reached
            - user_is_owner
            - failed_user_data_retrieval
            - permission_already_granted
            - other
      description: >
        success: User was successfully added to the Paper doc.

        unknown_error: Something unexpected happened when trying to add the user
        to the Paper doc.

        sharing_outside_team_disabled: The Paper doc can be shared only with
        team members.

        daily_limit_reached: The daily limit of how many users can be added to
        the Paper doc was reached.

        user_is_owner: Owner's permissions cannot be changed.

        failed_user_data_retrieval: User data could not be retrieved. Clients
        should retry.

        permission_already_granted: This user already has the correct permission
        to the Paper doc.

        other: None
    DownloadZipResult:
      type: object
      properties:
        metadata:
          $ref: '#/components/schemas/FolderMetadata'
      description: |
        metadata: None
    ListFolderResult:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            Pass the cursor into :route:`list_folder/continue` to see what's
            changed in the folder since your previous query.
        has_more:
          type: boolean
          description: >-
            If true, then there are more entries available. Pass the cursor to
            :route:`list_folder/continue` to retrieve the rest.
        entries:
          type: array
          description: The files and (direct) subfolders in the folder.
          items:
            $ref: '#/components/schemas/Metadata'
      description: >
        entries: The files and (direct) subfolders in the folder.

        cursor: Pass the cursor into :route:`list_folder/continue` to see what's
        changed in the folder since your previous query.

        has_more: If true, then there are more entries available. Pass the
        cursor to :route:`list_folder/continue` to retrieve the rest.
    SharedFolderMemberError:
      type: object
      properties:
        .tag:
          title: Choice of SharedFolderMemberError
          type: string
          enum:
            - invalid_dropbox_id
            - not_a_member
            - no_explicit_access
            - other
        no_explicit_access:
          $ref: '#/components/schemas/MemberAccessLevelResult'
      description: >
        invalid_dropbox_id: The target dropbox_id is invalid.

        not_a_member: The target dropbox_id is not a member of the shared
        folder.

        no_explicit_access: The target member only has inherited access to the
        shared folder.

        other: None
    RevokeSharedLinkError:
      type: object
      properties:
        .tag:
          title: Choice of RevokeSharedLinkError
          type: string
          enum:
            - shared_link_not_found
            - shared_link_access_denied
            - unsupported_link_type
            - other
            - shared_link_malformed
      description: >
        shared_link_not_found: The shared link wasn't found.

        shared_link_access_denied: The caller is not allowed to access this
        shared link.

        unsupported_link_type: This type of link is not supported.

        other: None

        shared_link_malformed: Shared link is malformed.
    WriteMode:
      type: object
      properties:
        .tag:
          title: Choice of WriteMode
          type: string
          enum:
            - add
            - overwrite
            - update
        update:
          type: string
          description: >-
            Overwrite if the given "rev" matches the existing file's "rev". The
            autorename strategy is to append the string "conflicted copy" to the
            file name. For example, "document.txt" might become "document
            (conflicted copy).txt" or "document (Panda's conflicted copy).txt".
      description: >
        Your intent when writing a file to some path. This is used to determine
        what constitutes a conflict and what the autorename strategy is.

        In some situations, the conflict behavior is identical: (a) If the
        target path doesn't refer to anything, the file is always written; no
        conflict. (b) If the target path refers to a folder, it's always a
        conflict. (c) If the target path refers to a file with identical
        contents, nothing gets written; no conflict.

        The conflict checking differs in the case where there's a file at the
        target path with contents different from the contents you're trying to
        write.

        add: Do not overwrite an existing file if there is a conflict. The
        autorename strategy is to append a number to the file name. For example,
        "document.txt" might become "document (2).txt".

        overwrite: Always overwrite the existing file. The autorename strategy
        is the same as it is for :field:`add`.

        update: Overwrite if the given "rev" matches the existing file's "rev".
        The autorename strategy is to append the string "conflicted copy" to the
        file name. For example, "document.txt" might become "document
        (conflicted copy).txt" or "document (Panda's conflicted copy).txt".
    GroupInfo:
      type: object
      properties:
        group_external_id:
          type: string
          description: >-
            External ID of group. This is an arbitrary ID that an admin can
            attach to a group.
        is_owner:
          type: boolean
          description: If the current user is an owner of the group.
        member_count:
          type: number
          description: The number of members in the group.
        same_team:
          type: boolean
          description: If the group is owned by the current user's team.
        is_member:
          type: boolean
          description: If the current user is a member of the group.
        group_management_type:
          $ref: '#/components/schemas/GroupManagementType'
        group_name:
          type: string
        group_id:
          type: string
        group_type:
          $ref: '#/components/schemas/GroupType'
      description: >
        The information about a group. Groups is a way to manage a list of
        users  who need same access permission to the shared folder.

        group_name: None

        group_id: None

        group_management_type: Who is allowed to manage the group.

        group_type: The type of group.

        is_member: If the current user is a member of the group.

        is_owner: If the current user is an owner of the group.

        same_team: If the group is owned by the current user's team.

        group_external_id: External ID of group. This is an arbitrary ID that an
        admin can attach to a group.

        member_count: The number of members in the group.
    ListSharedLinksError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of ListSharedLinksError
          type: string
          enum:
            - path
            - reset
            - other
      description: >
        path: None

        reset: Indicates that the cursor has been invalidated. Call
        :route:`list_shared_links` to obtain a new cursor.

        other: None
    AddTemplateArg:
      type: object
      properties:
        fields:
          type: array
          description: >-
            Definitions of the property fields associated with this template.
            There can be up to 32 properties in a single template.
          items:
            $ref: '#/components/schemas/PropertyFieldTemplate'
        name:
          type: string
          description: >-
            Display name for the template. Template names can be up to 256
            bytes.
        description:
          type: string
          description: >-
            Description for the template. Template descriptions can be up to
            1024 bytes.
      description: >
        name: Display name for the template. Template names can be up to 256
        bytes.

        description: Description for the template. Template descriptions can be
        up to 1024 bytes.

        fields: Definitions of the property fields associated with this
        template. There can be up to 32 properties in a single template.
    Cursor:
      type: object
      properties:
        expiration:
          type: string
          description: >-
            Expiration time of :field:`value`.

            Some cursors might have expiration time assigned. This is a UTC
            value after which the cursor is no longer valid and the API starts
            returning an error. If cursor expires a new one needs to be obtained
            and pagination needs to be restarted. Some cursors might be
            short-lived some cursors might be long-lived.

            This really depends on the sorting type and order, e.g.:

            1. on one hand, listing docs created by the user, sorted by the
            created time ascending will have undefinite expiration because the
            results cannot change while the iteration is happening. This cursor
            would be suitable for long term polling.

            2. on the other hand, listing docs sorted by the last modified time
            will have a very short expiration as docs do get modified very often
            and the modified time can be changed while the iteration is
            happening thus altering the results.
        value:
          type: string
          description: The actual cursor value.
      description: >
        value: The actual cursor value.

        expiration: Expiration time of :field:`value`.

        Some cursors might have expiration time assigned. This is a UTC value
        after which the cursor is no longer valid and the API starts returning
        an error. If cursor expires a new one needs to be obtained and
        pagination needs to be restarted. Some cursors might be short-lived some
        cursors might be long-lived.

        This really depends on the sorting type and order, e.g.:

        1. on one hand, listing docs created by the user, sorted by the created
        time ascending will have undefinite expiration because the results
        cannot change while the iteration is happening. This cursor would be
        suitable for long term polling.

        2. on the other hand, listing docs sorted by the last modified time will
        have a very short expiration as docs do get modified very often and the
        modified time can be changed while the iteration is happening thus
        altering the results.
    AddTemplateResult:
      type: object
      properties:
        template_id:
          type: string
          description: >-
            An identifier for template added by  See
            :route:`templates/add_for_user` or :route:`templates/add_for_team`.
      description: >
        template_id: An identifier for template added by  See
        :route:`templates/add_for_user` or :route:`templates/add_for_team`.
    UnshareFolderError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of UnshareFolderError
          type: string
          enum:
            - access_error
            - team_folder
            - no_permission
            - too_many_files
            - other
      description: >
        access_error: None

        team_folder: This action cannot be performed on a team shared folder.

        no_permission: The current user does not have permission to perform this
        action.

        too_many_files: This shared folder has too many files to be unshared.

        other: None
    MemberPermission:
      type: object
      properties:
        action:
          $ref: '#/components/schemas/MemberAction'
        reason:
          $ref: '#/components/schemas/PermissionDeniedReason'
        allow:
          type: boolean
          description: True if the user is allowed to take the action.
      description: >
        Whether the user is allowed to take the action on the associated member.

        action: The action that the user may wish to take on the member.

        allow: True if the user is allowed to take the action.

        reason: The reason why the user is denied the permission. Not present if
        the action is allowed.
    SharingFileAccessError:
      type: object
      properties:
        .tag:
          title: Choice of SharingFileAccessError
          type: string
          enum:
            - no_permission
            - invalid_file
            - is_folder
            - inside_public_folder
            - inside_osx_package
            - other
      description: >
        User could not access this file.

        no_permission: Current user does not have sufficient privileges to
        perform the desired action.

        invalid_file: File specified was not found.

        is_folder: A folder can't be shared this way. Use folder sharing or a
        shared link instead.

        inside_public_folder: A file inside a public folder can't be shared this
        way. Use a public link instead.

        inside_osx_package: A Mac OS X package can't be shared this way. Use a
        shared link instead.

        other: None
    SearchMatch:
      type: object
      properties:
        match_type:
          $ref: '#/components/schemas/SearchMatchType'
        metadata:
          $ref: '#/components/schemas/Metadata'
      description: |
        match_type: The type of the match.
        metadata: The metadata for the matched file or folder.
    ListFileMembersContinueError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of ListFileMembersContinueError
          type: string
          enum:
            - user_error
            - access_error
            - invalid_cursor
            - other
        user_error:
          $ref: '#/components/schemas/SharingUserError'
      description: |
        Error for :route:`list_file_members/continue`.
        user_error: None
        access_error: None
        invalid_cursor: :field:`ListFileMembersContinueArg.cursor` is invalid.
        other: None
    GetTemporaryLinkArg:
      type: object
      properties:
        path:
          type: string
          description: The path to the file you want a temporary link to.
      description: |
        path: The path to the file you want a temporary link to.
    GetCopyReferenceError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of GetCopyReferenceError
          type: string
          enum:
            - path
            - other
      description: |
        path: None
        other: None
    AudienceRestrictingSharedFolder:
      type: object
      properties:
        shared_folder_id:
          type: string
          description: The ID of the shared folder.
        audience:
          $ref: '#/components/schemas/LinkAudience'
        name:
          type: string
          description: The name of the shared folder.
      description: >
        Information about the shared folder that prevents the link audience for
        this link from being more restrictive.

        shared_folder_id: The ID of the shared folder.

        name: The name of the shared folder.

        audience: The link audience of the shared folder.
    GetTemporaryLinkError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of GetTemporaryLinkError
          type: string
          enum:
            - path
            - other
      description: |
        path: None
        other: None
    PollArg:
      type: object
      properties:
        async_job_id:
          type: string
          description: >-
            Id of the asynchronous job. This is the value of a response returned
            from the method that launched the job.
      description: >
        Arguments for methods that poll the status of an asynchronous job.

        async_job_id: Id of the asynchronous job. This is the value of a
        response returned from the method that launched the job.
    UserInfo:
      type: object
      properties:
        email:
          type: string
          description: Email address of user.
        team_member_id:
          type: string
          description: >-
            The team member ID of the shared folder member. Only present if
            :field:`same_team` is true.
        display_name:
          type: string
          description: The display name of the user.
        account_id:
          type: string
          description: The account ID of the user.
        same_team:
          type: boolean
          description: If the user is in the same team as current user.
      description: >
        Basic information about a user. Use :route:`users.get_account` and
        :route:`users.get_account_batch` to obtain more detailed information.

        account_id: The account ID of the user.

        email: Email address of user.

        display_name: The display name of the user.

        same_team: If the user is in the same team as current user.

        team_member_id: The team member ID of the shared folder member. Only
        present if :field:`same_team` is true.
    UploadErrorWithProperties:
      type: object
      properties:
        properties_error:
          $ref: '#/components/schemas/InvalidPropertyGroupError'
        path:
          $ref: '#/components/schemas/UploadWriteFailed'
        .tag:
          title: Choice of UploadErrorWithProperties
          type: string
          enum:
            - path
            - properties_error
            - other
      description: >
        path: Unable to save the uploaded contents to a file.

        properties_error: The supplied property group is invalid. The file has
        uploaded without property groups.

        other: None
    AccessLevel:
      type: object
      properties:
        .tag:
          title: Choice of AccessLevel
          type: string
          enum:
            - owner
            - editor
            - viewer
            - viewer_no_comment
            - other
      description: >
        Defines the access levels for collaborators.

        owner: The collaborator is the owner of the shared folder. Owners can
        view and edit the shared folder as well as set the folder's policies
        using :route:`update_folder_policy`.

        editor: The collaborator can both view and edit the shared folder.

        viewer: The collaborator can only view the shared folder.

        viewer_no_comment: The collaborator can only view the shared folder and
        does not have any access to comments.

        other: None
    ThumbnailFormat:
      type: object
      properties:
        .tag:
          title: Choice of ThumbnailFormat
          type: string
          enum:
            - jpeg
            - png
      description: |
        jpeg: None
        png: None
    CreateSharedLinkArg:
      type: object
      properties:
        path:
          type: string
          description: The path to share.
        pending_upload:
          $ref: '#/components/schemas/PendingUploadMode'
        short_url:
          type: boolean
          description: Whether to return a shortened URL.
      description: >
        path: The path to share.

        short_url: Whether to return a shortened URL.

        pending_upload: If it's okay to share a path that does not yet exist,
        set this to either :field:`PendingUploadMode.file` or
        :field:`PendingUploadMode.folder` to indicate whether to assume it's a
        file or folder.
    ShareFolderError:
      type: object
      properties:
        bad_path:
          $ref: '#/components/schemas/SharePathError'
        .tag:
          title: Choice of ShareFolderError
          type: string
          enum:
            - email_unverified
            - bad_path
            - team_policy_disallows_member_policy
            - disallowed_shared_link_policy
            - other
            - no_permission
      description: >
        email_unverified: The current user's e-mail address is unverified.

        bad_path: :field:`ShareFolderArg.path` is invalid.

        team_policy_disallows_member_policy: Team policy is more restrictive
        than :field:`ShareFolderArg.member_policy`.

        disallowed_shared_link_policy: The current user's account is not allowed
        to select the specified :field:`ShareFolderArg.shared_link_policy`.

        other: None

        no_permission: The current user does not have permission to perform this
        action.
    GetAccountArg:
      type: object
      properties:
        account_id:
          type: string
          description: A user's account identifier.
      description: |
        account_id: A user's account identifier.
    SymlinkInfo:
      type: object
      properties:
        target:
          type: string
          description: The target this symlink points to.
      description: |
        target: The target this symlink points to.
    SharingUserError:
      type: object
      properties:
        .tag:
          title: Choice of SharingUserError
          type: string
          enum:
            - email_unverified
            - other
      description: >
        User account had a problem preventing this action.

        email_unverified: The current user must verify the account e-mail
        address before performing this action.

        other: None
    SharedFolderAccessError:
      type: object
      properties:
        .tag:
          title: Choice of SharedFolderAccessError
          type: string
          enum:
            - invalid_id
            - not_a_member
            - email_unverified
            - unmounted
            - other
      description: >
        There is an error accessing the shared folder.

        invalid_id: This shared folder ID is invalid.

        not_a_member: The user is not a member of the shared folder thus cannot
        access it.

        email_unverified: Never set.

        unmounted: The shared folder is unmounted.

        other: None
    FolderSharingPolicyType:
      type: object
      properties:
        .tag:
          title: Choice of FolderSharingPolicyType
          type: string
          enum:
            - team
            - invite_only
      description: >
        The sharing policy of a Paper folder.


        Note: The sharing policy of subfolders is inherited from the root
        folder.

        team: Everyone in your team and anyone directly invited can access this
        folder.

        invite_only: Only people directly invited can access this folder.
    GroupManagementType:
      type: object
      properties:
        .tag:
          title: Choice of GroupManagementType
          type: string
          enum:
            - user_managed
            - company_managed
            - system_managed
            - other
      description: |
        The group type determines how a group is managed.
        user_managed: A group which is managed by selected users.
        company_managed: A group which is managed by team admins only.
        system_managed: A group which is managed automatically by Dropbox.
        other: None
    AddPaperDocUserMemberResult:
      type: object
      properties:
        member:
          $ref: '#/components/schemas/MemberSelector'
        result:
          $ref: '#/components/schemas/AddPaperDocUserResult'
      description: |
        Per-member result for :route:`docs/users/add`.
        member: One of specified input members.
        result: The outcome of the action on this member.
    DocLookupError:
      type: object
      properties:
        .tag:
          title: Choice of DocLookupError
          type: string
          enum:
            - insufficient_permissions
            - other
            - doc_not_found
      description: >
        insufficient_permissions: Your account does not have permissions to
        perform this action.

        other: None

        doc_not_found: The required doc was not found.
    ListFolderLongpollArg:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            A cursor as returned by :route:`list_folder` or
            :route:`list_folder/continue`. Cursors retrieved by setting
            :field:`ListFolderArg.include_media_info` to :val:`true` are not
            supported.
        timeout:
          type: number
          description: >-
            A timeout in seconds. The request will block for at most this length
            of time, plus up to 90 seconds of random jitter added to avoid the
            thundering herd problem. Care should be taken when using this
            parameter, as some network infrastructure does not support long
            timeouts.
      description: >
        cursor: A cursor as returned by :route:`list_folder` or
        :route:`list_folder/continue`. Cursors retrieved by setting
        :field:`ListFolderArg.include_media_info` to :val:`true` are not
        supported.

        timeout: A timeout in seconds. The request will block for at most this
        length of time, plus up to 90 seconds of random jitter added to avoid
        the thundering herd problem. Care should be taken when using this
        parameter, as some network infrastructure does not support long
        timeouts.
    UploadError:
      type: object
      properties:
        properties_error:
          $ref: '#/components/schemas/InvalidPropertyGroupError'
        path:
          $ref: '#/components/schemas/UploadWriteFailed'
        .tag:
          title: Choice of UploadError
          type: string
          enum:
            - path
            - properties_error
            - other
      description: >
        path: Unable to save the uploaded contents to a file.

        properties_error: The supplied property group is invalid. The file has
        uploaded without property groups.

        other: None
    PaperDocUpdateArgs:
      type: object
      properties:
        doc_update_policy:
          $ref: '#/components/schemas/PaperDocUpdatePolicy'
        doc_id:
          type: string
          description: The Paper doc ID.
        import_format:
          $ref: '#/components/schemas/ImportFormat'
        revision:
          type: number
          description: >-
            The latest doc revision. This value must match the head revision or
            an error code will be returned. This is to prevent colliding writes.
      description: >
        doc_id: The Paper doc ID.

        doc_update_policy: The policy used for the current update call.

        revision: The latest doc revision. This value must match the head
        revision or an error code will be returned. This is to prevent colliding
        writes.

        import_format: The format of provided data.
    GetFileMetadataIndividualResult:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of GetFileMetadataIndividualResult
          type: string
          enum:
            - metadata
            - access_error
            - other
        metadata:
          $ref: '#/components/schemas/SharedFileMetadata'
      description: |
        metadata: The result for this file if it was successful.
        access_error: The result for this file if it was an error.
        other: None
    SaveCopyReferenceResult:
      type: object
      properties:
        metadata:
          $ref: '#/components/schemas/Metadata'
      description: >
        metadata: The metadata of the saved file or folder in the user's
        Dropbox.
    SaveUrlJobStatus:
      type: object
      properties:
        failed:
          $ref: '#/components/schemas/SaveUrlError'
        .tag:
          title: Choice of SaveUrlJobStatus
          type: string
          enum:
            - in_progress
            - complete
            - failed
        complete:
          $ref: '#/components/schemas/FileMetadata'
      description: |
        in_progress: The asynchronous job is still in progress.
        complete: Metadata of the file where the URL is saved to.
        failed: None
    GetMetadataArg:
      type: object
      properties:
        path:
          type: string
          description: The path of a file or folder on Dropbox.
        include_has_explicit_shared_members:
          type: boolean
          description: >-
            If true, the results will include a flag for each file indicating
            whether or not  that file has any explicit members.
        include_property_groups:
          $ref: '#/components/schemas/TemplateFilterBase'
        include_deleted:
          type: boolean
          description: >-
            If true, :type:`DeletedMetadata` will be returned for deleted file
            or folder, otherwise :field:`LookupError.not_found` will be
            returned.
        include_media_info:
          type: boolean
          description: >-
            If true, :field:`FileMetadata.media_info` is set for photo and
            video.
      description: >
        path: The path of a file or folder on Dropbox.

        include_media_info: If true, :field:`FileMetadata.media_info` is set for
        photo and video.

        include_deleted: 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: If true, the results will include a
        flag for each file indicating whether or not  that file has any explicit
        members.

        include_property_groups: If set to a valid list of template IDs,
        :field:`FileMetadata.property_groups` is set if there exists property
        data associated with the file and each of the listed templates.
    SharedFolderMemberPolicy:
      type: object
      properties:
        .tag:
          title: Choice of SharedFolderMemberPolicy
          type: string
          enum:
            - team
            - anyone
            - other
      description: >
        Policy governing who can be a member of a folder shared by a team
        member.

        team: Only a teammate can be a member of a folder shared by a team
        member.

        anyone: Anyone can be a member of a folder shared by a team member.

        other: None
    GetTemplateArg:
      type: object
      properties:
        template_id:
          type: string
          description: >-
            An identifier for template added by route  See
            :route:`templates/add_for_user` or :route:`templates/add_for_team`.
      description: >
        template_id: An identifier for template added by route  See
        :route:`templates/add_for_user` or :route:`templates/add_for_team`.
    RestoreError:
      type: object
      properties:
        path_lookup:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of RestoreError
          type: string
          enum:
            - path_lookup
            - path_write
            - invalid_revision
            - other
        path_write:
          $ref: '#/components/schemas/WriteError'
      description: >
        path_lookup: An error occurs when downloading metadata for the file.

        path_write: An error occurs when trying to restore the file to that
        path.

        invalid_revision: The revision is invalid. It may point to a different
        file.

        other: None
    RelocationBatchResult:
      type: object
      properties:
        entries:
          type: array
          items:
            $ref: '#/components/schemas/RelocationBatchResultData'
      description: |
        entries: None
    FileMemberActionResult:
      type: object
      properties:
        member:
          $ref: '#/components/schemas/MemberSelector'
        result:
          $ref: '#/components/schemas/FileMemberActionIndividualResult'
      description: >
        Per-member result for :route:`add_file_member` or
        :route:`change_file_member_access`.

        member: One of specified input members.

        result: The outcome of the action on this member.
    ModifySharedLinkSettingsError:
      type: object
      properties:
        .tag:
          title: Choice of ModifySharedLinkSettingsError
          type: string
          enum:
            - shared_link_not_found
            - shared_link_access_denied
            - unsupported_link_type
            - other
            - settings_error
            - email_not_verified
        settings_error:
          $ref: '#/components/schemas/SharedLinkSettingsError'
      description: >
        shared_link_not_found: The shared link wasn't found.

        shared_link_access_denied: The caller is not allowed to access this
        shared link.

        unsupported_link_type: This type of link is not supported.

        other: None

        settings_error: There is an error with the given settings.

        email_not_verified: The caller's email should be verified.
    UpdateFileRequestArgs:
      type: object
      properties:
        open:
          type: boolean
          description: Whether to set this file request as open or closed.
        destination:
          type: string
          description: >-
            The new path of the folder in the Dropbox where uploaded files will
            be sent. For apps with the app folder permission, this will be
            relative to the app folder.
        deadline:
          $ref: '#/components/schemas/UpdateFileRequestDeadline'
        id:
          type: string
          description: The ID of the file request to update.
        title:
          type: string
          description: The new title of the file request. Must not be empty.
      description: >
        Arguments for :route:`update`.

        id: The ID of the file request to update.

        title: The new title of the file request. Must not be empty.

        destination: The new path of the folder in the Dropbox where uploaded
        files will be sent. For apps with the app folder permission, this will
        be relative to the app folder.

        deadline: The new deadline for the file request.

        open: Whether to set this file request as open or closed.
    TokenFromOAuth1Result:
      type: object
      properties:
        oauth2_token:
          type: string
          description: The OAuth 2.0 token generated from the supplied OAuth 1.0 token.
      description: >
        oauth2_token: The OAuth 2.0 token generated from the supplied OAuth 1.0
        token.
    Folder:
      type: object
      properties:
        id:
          type: string
          description: Paper folder ID. This ID uniquely identifies the folder.
        name:
          type: string
          description: Paper folder name.
      description: |
        Data structure representing a Paper folder.
        id: Paper folder ID. This ID uniquely identifies the folder.
        name: Paper folder name.
    RelinquishFolderMembershipArg:
      type: object
      properties:
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
        leave_a_copy:
          type: boolean
          description: Keep a copy of the folder's contents upon relinquishing membership.
      description: >
        shared_folder_id: The ID for the shared folder.

        leave_a_copy: Keep a copy of the folder's contents upon relinquishing
        membership.
    SaveUrlError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/WriteError'
        .tag:
          title: Choice of SaveUrlError
          type: string
          enum:
            - path
            - download_failed
            - invalid_url
            - not_found
            - other
      description: |
        path: None
        download_failed: Failed downloading the given URL.
        invalid_url: The given URL is invalid.
        not_found: The file where the URL is saved to no longer exists.
        other: None
    SharingPolicy:
      type: object
      properties:
        team_sharing_policy:
          $ref: '#/components/schemas/SharingTeamPolicyType'
        public_sharing_policy:
          $ref: '#/components/schemas/SharingPublicPolicyType'
      description: >
        Sharing policy of Paper doc.

        public_sharing_policy: This value applies to the non-team members.

        team_sharing_policy: This value applies to the team members only. The
        value is null for all personal accounts.
    LinkAudience:
      type: object
      properties:
        .tag:
          title: Choice of LinkAudience
          type: string
          enum:
            - public
            - team
            - members
            - other
      description: |
        public: Link is accessible by anyone.
        team: Link is accessible only by team members.
        members: Link is accessible only by members of the content.
        other: None
    SharedLinkAccessFailureReason:
      type: object
      properties:
        .tag:
          title: Choice of SharedLinkAccessFailureReason
          type: string
          enum:
            - login_required
            - email_verify_required
            - password_required
            - team_only
            - owner_only
            - other
      description: |
        login_required: User is not logged in.
        email_verify_required: User's email is not verified.
        password_required: The link is password protected.
        team_only: Access is allowed for team members only.
        owner_only: Access is allowed for the shared link's owner only.
        other: None
    PropertiesSearchQuery:
      type: object
      properties:
        query:
          type: string
          description: The property field value for which to search across templates.
        logical_operator:
          $ref: '#/components/schemas/LogicalOperator'
        mode:
          $ref: '#/components/schemas/PropertiesSearchMode'
      description: |
        query: The property field value for which to search across templates.
        mode: The mode with which to perform the search.
        logical_operator: The logical operator with which to append the query.
    PropertyGroupUpdate:
      type: object
      properties:
        remove_fields:
          type: array
          description: Property fields to remove (by name), provided they exist.
          items:
            type: string
        template_id:
          type: string
          description: A unique identifier for a property template.
        add_or_update_fields:
          type: array
          description: >-
            Property fields to update. If the property field already exists, it
            is updated. If the property field doesn't exist, the property group
            is added.
          items:
            $ref: '#/components/schemas/PropertyField'
      description: >
        template_id: A unique identifier for a property template.

        add_or_update_fields: Property fields to update. If the property field
        already exists, it is updated. If the property field doesn't exist, the
        property group is added.

        remove_fields: Property fields to remove (by name), provided they exist.
    ExportFormat:
      type: object
      properties:
        .tag:
          title: Choice of ExportFormat
          type: string
          enum:
            - html
            - markdown
            - other
      description: |
        The desired export format of the Paper doc.
        html: The HTML export format.
        markdown: The markdown export format.
        other: None
    FileSharingInfo:
      type: object
      properties:
        read_only:
          type: boolean
          description: True if the file or folder is inside a read-only shared folder.
        parent_shared_folder_id:
          type: string
          description: ID of shared folder that holds this file.
        modified_by:
          type: string
          description: >-
            The last user who modified the file. This field will be null if the
            user's account has been deleted.
      description: >
        Sharing info for a file which is contained by a shared folder.

        read_only: True if the file or folder is inside a read-only shared
        folder.

        parent_shared_folder_id: ID of shared folder that holds this file.

        modified_by: The last user who modified the file. This field will be
        null if the user's account has been deleted.
    SharedLink:
      type: object
      properties:
        url:
          type: string
          description: Shared link url.
        password:
          type: string
          description: Password for the shared link.
      description: |
        url: Shared link url.
        password: Password for the shared link.
    PaperDocCreateArgs:
      type: object
      properties:
        parent_folder_id:
          type: string
          description: >-
            The Paper folder ID where the Paper document should be created. The
            API user has to have write access to this folder or error is thrown.
        import_format:
          $ref: '#/components/schemas/ImportFormat'
      description: >
        import_format: The format of provided data.

        parent_folder_id: The Paper folder ID where the Paper document should be
        created. The API user has to have write access to this folder or error
        is thrown.
    Name:
      type: object
      properties:
        familiar_name:
          type: string
          description: >-
            Locale-dependent name. In the US, a person's familiar name is their
            :field:`given_name`, but elsewhere, it could be any combination of a
            person's :field:`given_name` and :field:`surname`.
        surname:
          type: string
          description: Also known as a last name or family name.
        display_name:
          type: string
          description: >-
            A name that can be used directly to represent the name of a user's
            Dropbox account.
        given_name:
          type: string
          description: Also known as a first name.
        abbreviated_name:
          type: string
          description: >-
            An abbreviated form of the person's name. Their initials in most
            locales.
      description: >
        Representations for a person's name to assist with internationalization.

        given_name: Also known as a first name.

        surname: Also known as a last name or family name.

        familiar_name: Locale-dependent name. In the US, a person's familiar
        name is their :field:`given_name`, but elsewhere, it could be any
        combination of a person's :field:`given_name` and :field:`surname`.

        display_name: A name that can be used directly to represent the name of
        a user's Dropbox account.

        abbreviated_name: An abbreviated form of the person's name. Their
        initials in most locales.
    ParentFolderAccessInfo:
      type: object
      properties:
        path:
          type: string
          description: >-
            The full path to the parent shared folder relative to the acting
            user's root.
        shared_folder_id:
          type: string
          description: The identifier of the parent shared folder.
        folder_name:
          type: string
          description: Display name for the folder.
        permissions:
          type: array
          description: The user's permissions for the parent shared folder.
          items:
            $ref: '#/components/schemas/MemberPermission'
      description: >
        Contains information about a parent folder that a member has access to.

        folder_name: Display name for the folder.

        shared_folder_id: The identifier of the parent shared folder.

        permissions: The user's permissions for the parent shared folder.

        path: The full path to the parent shared folder relative to the acting
        user's root.
    InvalidPropertyGroupError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of InvalidPropertyGroupError
          type: string
          enum:
            - template_not_found
            - restricted_content
            - other
            - path
            - unsupported_folder
            - property_field_too_large
            - does_not_fit_template
        template_not_found:
          type: string
          description: Template does not exist for the given identifier.
      description: >
        template_not_found: Template does not exist for the given identifier.

        restricted_content: You do not have permission to modify this template.

        other: None

        path: None

        unsupported_folder: This folder cannot be tagged. Tagging folders is not
        supported for team-owned templates.

        property_field_too_large: One or more of the supplied property field
        values is too large.

        does_not_fit_template: One or more of the supplied property fields does
        not conform to the template specifications.
    UploadSessionFinishBatchResult:
      type: object
      properties:
        entries:
          type: array
          description: Commit result for each file in the batch.
          items:
            $ref: '#/components/schemas/UploadSessionFinishBatchResultEntry'
      description: |
        entries: Commit result for each file in the batch.
    FileMemberActionIndividualResult:
      type: object
      properties:
        member_error:
          $ref: '#/components/schemas/FileMemberActionError'
        .tag:
          title: Choice of FileMemberActionIndividualResult
          type: string
          enum:
            - success
            - member_error
        success:
          $ref: '#/components/schemas/AccessLevel'
      description: >
        success: Member was successfully removed from this file. If AccessLevel
        is given, the member still has access via a parent shared folder.

        member_error: User was not able to perform this action.
    UpdateTemplateResult:
      type: object
      properties:
        template_id:
          type: string
          description: >-
            An identifier for template added by route  See
            :route:`templates/add_for_user` or :route:`templates/add_for_team`.
      description: >
        template_id: An identifier for template added by route  See
        :route:`templates/add_for_user` or :route:`templates/add_for_team`.
    UpdateFolderPolicyError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of UpdateFolderPolicyError
          type: string
          enum:
            - access_error
            - not_on_team
            - team_policy_disallows_member_policy
            - disallowed_shared_link_policy
            - no_permission
            - team_folder
            - other
      description: >
        access_error: None

        not_on_team: :field:`UpdateFolderPolicyArg.member_policy` was set even
        though user is not on a team.

        team_policy_disallows_member_policy: Team policy is more restrictive
        than :field:`ShareFolderArg.member_policy`.

        disallowed_shared_link_policy: The current account is not allowed to
        select the specified :field:`ShareFolderArg.shared_link_policy`.

        no_permission: The current user does not have permission to perform this
        action.

        team_folder: This action cannot be performed on a team shared folder.

        other: None
    GroupMembershipInfo:
      type: object
      properties:
        initials:
          type: string
          description: Never set.
        permissions:
          type: array
          description: >-
            The permissions that requesting user has on this member. The set of
            permissions corresponds to the MemberActions in the request.
          items:
            $ref: '#/components/schemas/MemberPermission'
        group:
          $ref: '#/components/schemas/GroupInfo'
        access_type:
          $ref: '#/components/schemas/AccessLevel'
        is_inherited:
          type: boolean
          description: True if the member has access from a parent folder.
      description: >
        The information about a group member of the shared content.

        access_type: The access type for this member.

        group: The information about the membership group.

        permissions: The permissions that requesting user has on this member.
        The set of permissions corresponds to the MemberActions in the request.

        initials: Never set.

        is_inherited: True if the member has access from a parent folder.
    AudienceExceptions:
      type: object
      properties:
        count:
          type: number
        exceptions:
          type: array
          description: >-
            A truncated list of some of the content that is an exception. The
            length of this list could be smaller than the count since it is only
            a sample but will not be empty as long as count is not 0.
          items:
            $ref: '#/components/schemas/AudienceExceptionContentInfo'
      description: >
        The total count and truncated list of information of content inside this
        folder that has a different audience than the link on this folder. This
        is only returned for folders.

        count: None

        exceptions: A truncated list of some of the content that is an
        exception. The length of this list could be smaller than the count since
        it is only a sample but will not be empty as long as count is not 0.
    PropertyType:
      type: object
      properties:
        .tag:
          title: Choice of PropertyType
          type: string
          enum:
            - string
            - other
      description: >
        Data type of the given property field added.

        string: The associated property field will be of type string. Unicode is
        supported.

        other: None
    AddFolderMemberError:
      type: object
      properties:
        too_many_members:
          type: number
          description: The value is the member limit that was reached.
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of AddFolderMemberError
          type: string
          enum:
            - access_error
            - email_unverified
            - bad_member
            - cant_share_outside_team
            - too_many_members
            - too_many_pending_invites
            - rate_limit
            - too_many_invitees
            - insufficient_plan
            - team_folder
            - no_permission
            - other
        bad_member:
          $ref: '#/components/schemas/AddMemberSelectorError'
        too_many_pending_invites:
          type: number
          description: The value is the pending invite limit that was reached.
      description: >
        access_error: Unable to access shared folder.

        email_unverified: The current user's e-mail address is unverified.

        bad_member: :field:`AddFolderMemberArg.members` contains a bad
        invitation recipient.

        cant_share_outside_team: Your team policy does not allow sharing outside
        of the team.

        too_many_members: The value is the member limit that was reached.

        too_many_pending_invites: The value is the pending invite limit that was
        reached.

        rate_limit: The current user has hit the limit of invites they can send
        per day. Try again in 24 hours.

        too_many_invitees: The current user is trying to share with too many
        people at once.

        insufficient_plan: The current user's account doesn't support this
        action. An example of this is when adding a read-only member. This
        action can only be performed by users that have upgraded to a Pro or
        Business plan.

        team_folder: This action cannot be performed on a team shared folder.

        no_permission: The current user does not have permission to perform this
        action.

        other: None
    RootInfo:
      type: object
      properties:
        root_namespace_id:
          type: string
          description: >-
            The namespace ID for user's root namespace. It will be the namespace
            ID of the shared team root if the user is member of a team with a
            separate team root. Otherwise it will be same as
            :field:`RootInfo.home_namespace_id`.
        home_namespace_id:
          type: string
          description: The namespace ID for user's home namespace.
      description: >
        Information about current user's root.

        root_namespace_id: The namespace ID for user's root namespace. It will
        be the namespace ID of the shared team root if the user is member of a
        team with a separate team root. Otherwise it will be same as
        :field:`RootInfo.home_namespace_id`.

        home_namespace_id: The namespace ID for user's home namespace.
    UploadSessionFinishBatchLaunch:
      type: object
      properties:
        .tag:
          title: Choice of UploadSessionFinishBatchLaunch
          type: string
          enum:
            - async_job_id
            - complete
            - other
        async_job_id:
          type: string
          description: >-
            This response indicates that the processing is asynchronous. The
            string is an id that can be used to obtain the status of the
            asynchronous job.
        complete:
          $ref: '#/components/schemas/UploadSessionFinishBatchResult'
      description: >
        Result returned by :route:`upload_session/finish_batch` that may either
        launch an asynchronous job or complete synchronously.

        async_job_id: This response indicates that the processing is
        asynchronous. The string is an id that can be used to obtain the status
        of the asynchronous job.

        complete: None

        other: None
    ListFileRequestsResult:
      type: object
      properties:
        file_requests:
          type: array
          description: >-
            The file requests owned by this user. Apps with the app folder
            permission will only see file requests in their app folder.
          items:
            $ref: '#/components/schemas/FileRequest'
      description: >
        Result for :route:`list`.

        file_requests: The file requests owned by this user. Apps with the app
        folder permission will only see file requests in their app folder.
    ListRevisionsError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of ListRevisionsError
          type: string
          enum:
            - path
            - other
      description: |
        path: None
        other: None
    FilePermission:
      type: object
      properties:
        action:
          $ref: '#/components/schemas/FileAction'
        reason:
          $ref: '#/components/schemas/PermissionDeniedReason'
        allow:
          type: boolean
          description: True if the user is allowed to take the action.
      description: >
        Whether the user is allowed to take the sharing action on the file.

        action: The action that the user may wish to take on the file.

        allow: True if the user is allowed to take the action.

        reason: The reason why the user is denied the permission. Not present if
        the action is allowed.
    ListFolderError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of ListFolderError
          type: string
          enum:
            - path
            - other
      description: |
        path: None
        other: None
    FileRequest:
      type: object
      properties:
        title:
          type: string
          description: The title of the file request.
        url:
          type: string
          description: The URL of the file request.
        destination:
          type: string
          description: >-
            The path of the folder in the Dropbox where uploaded files will be
            sent. This can be :val:`null` if the destination was removed. For
            apps with the app folder permission, this will be relative to the
            app folder.
        created:
          type: string
          description: When this file request was created.
        file_count:
          type: number
          description: The number of files this file request has received.
        deadline:
          $ref: '#/components/schemas/FileRequestDeadline'
        id:
          type: string
          description: The ID of the file request.
        is_open:
          type: boolean
          description: >-
            Whether or not the file request is open. If the file request is
            closed, it will not accept any more file submissions.
      description: >
        A :link:`file request https://www.dropbox.com/help/9090` for receiving
        files into the user's Dropbox account.

        id: The ID of the file request.

        url: The URL of the file request.

        title: The title of the file request.

        created: When this file request was created.

        is_open: Whether or not the file request is open. If the file request is
        closed, it will not accept any more file submissions.

        file_count: The number of files this file request has received.

        destination: The path of the folder in the Dropbox where uploaded files
        will be sent. This can be :val:`null` if the destination was removed.
        For apps with the app folder permission, this will be relative to the
        app folder.

        deadline: The deadline for this file request. Only set if the request
        has a deadline.
    InviteeInfoWithPermissionLevel:
      type: object
      properties:
        permission_level:
          $ref: '#/components/schemas/PaperDocPermissionLevel'
        invitee:
          $ref: '#/components/schemas/InviteeInfo'
      description: |
        invitee: Email address invited to the Paper doc.
        permission_level: Permission level for the invitee.
    SearchError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of SearchError
          type: string
          enum:
            - path
            - other
      description: |
        path: None
        other: None
    AddPropertiesError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of AddPropertiesError
          type: string
          enum:
            - template_not_found
            - restricted_content
            - other
            - path
            - unsupported_folder
            - property_field_too_large
            - does_not_fit_template
            - property_group_already_exists
        template_not_found:
          type: string
          description: Template does not exist for the given identifier.
      description: >
        template_not_found: Template does not exist for the given identifier.

        restricted_content: You do not have permission to modify this template.

        other: None

        path: None

        unsupported_folder: This folder cannot be tagged. Tagging folders is not
        supported for team-owned templates.

        property_field_too_large: One or more of the supplied property field
        values is too large.

        does_not_fit_template: One or more of the supplied property fields does
        not conform to the template specifications.

        property_group_already_exists: A property group associated with this
        template and file already exists.
    DeleteArg:
      type: object
      properties:
        path:
          type: string
          description: Path in the user's Dropbox to delete.
        parent_rev:
          type: string
          description: >-
            Perform delete if given "rev" matches the existing file's latest
            "rev". This field does not support deleting a folder.
      description: >
        path: Path in the user's Dropbox to delete.

        parent_rev: Perform delete if given "rev" matches the existing file's
        latest "rev". This field does not support deleting a folder.
    SharedLinkMetadata:
      type: object
      properties:
        name:
          type: string
          description: >-
            The linked file name (including extension). This never contains a
            slash.
        url:
          type: string
          description: URL of the shared link.
        expires:
          type: string
          description: Expiration time, if set. By default the link won't expire.
        path_lower:
          type: string
          description: >-
            The lowercased full path in the user's Dropbox. This always starts
            with a slash. This field will only be present only if the linked
            file is in the authenticated user's  dropbox.
        content_owner_team_info:
          $ref: '#/components/schemas/Team'
        link_permissions:
          $ref: '#/components/schemas/LinkPermissions'
        team_member_info:
          $ref: '#/components/schemas/TeamMemberInfo'
        id:
          type: string
          description: A unique identifier for the linked file.
      description: >
        The metadata of a shared link.

        url: URL of the shared link.

        name: The linked file name (including extension). This never contains a
        slash.

        link_permissions: The link's access permissions.

        id: A unique identifier for the linked file.

        expires: Expiration time, if set. By default the link won't expire.

        path_lower: The lowercased full path in the user's Dropbox. This always
        starts with a slash. This field will only be present only if the linked
        file is in the authenticated user's  dropbox.

        team_member_info: The team membership information of the link's owner. 
        This field will only be present  if the link's owner is a team member.

        content_owner_team_info: The team information of the content's owner.
        This field will only be present if the content's owner is a team member
        and the content's owner team is different from the link's owner team.
    AddMemberSelectorError:
      type: object
      properties:
        invalid_dropbox_id:
          type: string
          description: The value is the ID that could not be identified.
        invalid_email:
          type: string
          description: The value is the e-email address that is malformed.
        .tag:
          title: Choice of AddMemberSelectorError
          type: string
          enum:
            - automatic_group
            - invalid_dropbox_id
            - invalid_email
            - unverified_dropbox_id
            - group_deleted
            - group_not_on_team
            - other
        unverified_dropbox_id:
          type: string
          description: >-
            The value is the ID of the Dropbox user with an unverified e-mail
            address.  Invite unverified users by e-mail address instead of by
            their Dropbox ID.
      description: >
        automatic_group: Automatically created groups can only be added to team
        folders.

        invalid_dropbox_id: The value is the ID that could not be identified.

        invalid_email: The value is the e-email address that is malformed.

        unverified_dropbox_id: The value is the ID of the Dropbox user with an
        unverified e-mail address.  Invite unverified users by e-mail address
        instead of by their Dropbox ID.

        group_deleted: At least one of the specified groups in
        :field:`AddFolderMemberArg.members` is deleted.

        group_not_on_team: Sharing to a group that is not on the current user's
        team.

        other: None
    MemberAction:
      type: object
      properties:
        .tag:
          title: Choice of MemberAction
          type: string
          enum:
            - leave_a_copy
            - make_editor
            - make_owner
            - make_viewer
            - make_viewer_no_comment
            - remove
            - other
      description: >
        Actions that may be taken on members of a shared folder.

        leave_a_copy: Allow the member to keep a copy of the folder when
        removing.

        make_editor: Make the member an editor of the folder.

        make_owner: Make the member an owner of the folder.

        make_viewer: Make the member a viewer of the folder.

        make_viewer_no_comment: Make the member a viewer of the folder without
        commenting permissions.

        remove: Remove the member from the folder.

        other: None
    ListRevisionsResult:
      type: object
      properties:
        is_deleted:
          type: boolean
          description: >-
            If the file identified by the latest revision in the response is
            either deleted or moved.
        server_deleted:
          type: string
          description: The time of deletion if the file was deleted.
        entries:
          type: array
          description: >-
            The revisions for the file. Only revisions that are not deleted will
            show up here.
          items:
            $ref: '#/components/schemas/FileMetadata'
      description: >
        is_deleted: If the file identified by the latest revision in the
        response is either deleted or moved.

        entries: The revisions for the file. Only revisions that are not deleted
        will show up here.

        server_deleted: The time of deletion if the file was deleted.
    RelocationError:
      type: object
      properties:
        to:
          $ref: '#/components/schemas/WriteError'
        from_lookup:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of RelocationError
          type: string
          enum:
            - from_lookup
            - from_write
            - to
            - cant_copy_shared_folder
            - cant_nest_shared_folder
            - cant_move_folder_into_itself
            - too_many_files
            - duplicated_or_nested_paths
            - cant_transfer_ownership
            - insufficient_quota
            - other
        from_write:
          $ref: '#/components/schemas/WriteError'
      description: >
        from_lookup: None

        from_write: None

        to: None

        cant_copy_shared_folder: Shared folders can't be copied.

        cant_nest_shared_folder: Your move operation would result in nested
        shared folders.  This is not allowed.

        cant_move_folder_into_itself: You cannot move a folder into itself.

        too_many_files: The operation would involve more than 10,000 files and
        folders.

        duplicated_or_nested_paths: There are duplicated/nested paths among
        :field:`RelocationArg.from_path` and :field:`RelocationArg.to_path`.

        cant_transfer_ownership: Your move operation would result in an
        ownership transfer. You may reissue the request with the field
        :field:`RelocationArg.allow_ownership_transfer` to true.

        insufficient_quota: The current user does not have enough space to move
        or copy the files.

        other: None
    LinkPassword:
      type: object
      properties:
        .tag:
          title: Choice of LinkPassword
          type: string
          enum:
            - remove_password
            - set_password
            - other
        set_password:
          type: string
          description: Set a new password or change an existing password.
      description: |
        remove_password: Remove the currently set password for the link.
        set_password: Set a new password or change an existing password.
        other: None
    UnmountFolderError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of UnmountFolderError
          type: string
          enum:
            - access_error
            - no_permission
            - not_unmountable
            - other
      description: >
        access_error: None

        no_permission: The current user does not have permission to perform this
        action.

        not_unmountable: The shared folder can't be unmounted. One example where
        this can occur is when the shared folder's parent folder is also a
        shared folder that resides in the current user's Dropbox.

        other: None
    GroupType:
      type: object
      properties:
        .tag:
          title: Choice of GroupType
          type: string
          enum:
            - team
            - user_managed
            - other
      description: >
        The group type determines how a group is created and managed.

        team: A group to which team members are automatically added. Applicable
        to :link:`team folders https://www.dropbox.com/help/986` only.

        user_managed: A group is created and managed by a user.

        other: None
    ThumbnailArg:
      type: object
      properties:
        path:
          type: string
          description: The path to the image file you want to thumbnail.
        size:
          $ref: '#/components/schemas/ThumbnailSize'
        mode:
          $ref: '#/components/schemas/ThumbnailMode'
        format:
          $ref: '#/components/schemas/ThumbnailFormat'
      description: >
        path: The path to the image file you want to thumbnail.

        format: The format for the thumbnail image, jpeg (default) or png. For 
        images that are photos, jpeg should be preferred, while png is  better
        for screenshots and digital arts.

        size: The size for the thumbnail image.

        mode: How to resize and crop the image to achieve the desired size.
    ListSharedLinksArg:
      type: object
      properties:
        cursor:
          type: string
          description: The cursor returned by your last call to :route:`list_shared_links`.
        path:
          type: string
          description: See :route:`list_shared_links` description.
        direct_only:
          type: boolean
          description: See :route:`list_shared_links` description.
      description: >
        path: See :route:`list_shared_links` description.

        cursor: The cursor returned by your last call to
        :route:`list_shared_links`.

        direct_only: See :route:`list_shared_links` description.
    ListFileMembersError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of ListFileMembersError
          type: string
          enum:
            - user_error
            - access_error
            - other
        user_error:
          $ref: '#/components/schemas/SharingUserError'
      description: |
        Error for :route:`list_file_members`.
        user_error: None
        access_error: None
        other: None
    UnshareFileArg:
      type: object
      properties:
        file:
          type: string
          description: The file to unshare.
      description: |
        Arguments for :route:`unshare_file`.
        file: The file to unshare.
    PaperDocCreateError:
      type: object
      properties:
        .tag:
          title: Choice of PaperDocCreateError
          type: string
          enum:
            - insufficient_permissions
            - other
            - content_malformed
            - folder_not_found
            - doc_length_exceeded
            - image_size_exceeded
      description: >
        insufficient_permissions: Your account does not have permissions to
        perform this action.

        other: None

        content_malformed: The provided content was malformed and cannot be
        imported to Paper.

        folder_not_found: The specified Paper folder is cannot be found.

        doc_length_exceeded: The newly created Paper doc would be too large.
        Please split the content into multiple docs.

        image_size_exceeded: The imported document contains an image that is too
        large. The current limit is 1MB. Note: This only applies to HTML with
        data uri.
    PropertiesSearchArg:
      type: object
      properties:
        template_filter:
          $ref: '#/components/schemas/TemplateFilter'
        queries:
          type: array
          description: Queries to search.
          items:
            $ref: '#/components/schemas/PropertiesSearchQuery'
      description: >
        queries: Queries to search.

        template_filter: Filter results to contain only properties associated
        with these template IDs.
    FileMetadata:
      type: object
      properties:
        parent_shared_folder_id:
          type: string
          description: >-
            Please use :field:`FileSharingInfo.parent_shared_folder_id` or
            :field:`FolderSharingInfo.parent_shared_folder_id` instead.
        name:
          type: string
          description: >-
            The last component of the path (including extension). This never
            contains a slash.
        property_groups:
          type: array
          description: >-
            Additional information if the file has custom properties with the
            property template specified.
          items:
            $ref: '#/components/schemas/PropertyGroup'
        rev:
          type: string
          description: >-
            A unique identifier for the current revision of a file. This field
            is the same rev as elsewhere in the API and can be used to detect
            changes and avoid conflicts.
        client_modified:
          type: string
          description: >-
            For files, this is the modification time set by the desktop client
            when the file was added to Dropbox. Since this time is not verified
            (the Dropbox server stores whatever the desktop client sends up),
            this should only be used for display purposes (such as sorting) and
            not, for example, to determine if a file has changed or not.
        symlink_info:
          $ref: '#/components/schemas/SymlinkInfo'
        path_display:
          type: string
          description: >-
            The cased path to be used for display purposes only. In rare
            instances the casing will not correctly match the user's filesystem,
            but this behavior will match the path provided in the Core API v1,
            and at least the last path component will have the correct casing.
            Changes to only the casing of paths won't be returned by
            :route:`list_folder/continue`. This field will be null if the file
            or folder is not mounted.
        has_explicit_shared_members:
          type: boolean
          description: >-
            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.
        path_lower:
          type: string
          description: >-
            The lowercased full path in the user's Dropbox. This always starts
            with a slash. This field will be null if the file or folder is not
            mounted.
        server_modified:
          type: string
          description: The last time the file was modified on Dropbox.
        sharing_info:
          $ref: '#/components/schemas/FileSharingInfo'
        media_info:
          $ref: '#/components/schemas/MediaInfo'
        content_hash:
          type: string
          description: >-
            A hash of the file content. This field can be used to verify data
            integrity. For more information see our :link:`Content hash
            /developers/reference/content-hash` page.
        id:
          type: string
          description: A unique identifier for the file.
        size:
          type: number
          description: The file size in bytes.
      description: >
        name: The last component of the path (including extension). This never
        contains a slash.

        id: A unique identifier for the file.

        client_modified: For files, this is the modification time set by the
        desktop client when the file was added to Dropbox. Since this time is
        not verified (the Dropbox server stores whatever the desktop client
        sends up), this should only be used for display purposes (such as
        sorting) and not, for example, to determine if a file has changed or
        not.

        server_modified: The last time the file was modified on Dropbox.

        rev: A unique identifier for the current revision of a file. This field
        is the same rev as elsewhere in the API and can be used to detect
        changes and avoid conflicts.

        size: The file size in bytes.

        path_lower: The lowercased full path in the user's Dropbox. This always
        starts with a slash. This field will be null if the file or folder is
        not mounted.

        path_display: The cased path to be used for display purposes only. In
        rare instances the casing will not correctly match the user's
        filesystem, but this behavior will match the path provided in the Core
        API v1, and at least the last path component will have the correct
        casing. Changes to only the casing of paths won't be returned by
        :route:`list_folder/continue`. This field will be null if the file or
        folder is not mounted.

        parent_shared_folder_id: Please use
        :field:`FileSharingInfo.parent_shared_folder_id` or
        :field:`FolderSharingInfo.parent_shared_folder_id` instead.

        media_info: Additional information if the file is a photo or video.

        symlink_info: Set if this file is a symlink.

        sharing_info: Set if this file is contained in a shared folder.

        property_groups: Additional information if the file has custom
        properties with the property template specified.

        has_explicit_shared_members: 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.

        content_hash: A hash of the file content. This field can be used to
        verify data integrity. For more information see our :link:`Content hash
        /developers/reference/content-hash` page.
    UploadSessionStartArg:
      type: object
      properties:
        close:
          type: boolean
          description: >-
            If true, the current session will be closed, at which point you
            won't be able to call :route:`upload_session/append_v2` anymore with
            the current session.
      description: >
        close: If true, the current session will be closed, at which point you
        won't be able to call :route:`upload_session/append_v2` anymore with the
        current session.
    SearchArg:
      type: object
      properties:
        start:
          type: number
          description: The starting index within the search results (used for paging).
        max_results:
          type: number
          description: The maximum number of search results to return.
        path:
          type: string
          description: >-
            The path in the user's Dropbox to search. Should probably be a
            folder.
        mode:
          $ref: '#/components/schemas/SearchMode'
        query:
          type: string
          description: >-
            The string to search for. The search string is split on spaces into
            multiple tokens. For file name searching, the last token is used for
            prefix matching (i.e. "bat c" matches "bat cave" but not "batman
            car").
      description: >
        path: The path in the user's Dropbox to search. Should probably be a
        folder.

        query: The string to search for. The search string is split on spaces
        into multiple tokens. For file name searching, the last token is used
        for prefix matching (i.e. "bat c" matches "bat cave" but not "batman
        car").

        start: The starting index within the search results (used for paging).

        max_results: The maximum number of search results to return.

        mode: The search mode (filename, filename_and_content, or
        deleted_filename). Note that searching file content is only available
        for Dropbox Business accounts.
    RelinquishFolderMembershipError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of RelinquishFolderMembershipError
          type: string
          enum:
            - access_error
            - folder_owner
            - mounted
            - group_access
            - team_folder
            - no_permission
            - no_explicit_access
            - other
      description: >
        access_error: None

        folder_owner: The current user is the owner of the shared folder. Owners
        cannot relinquish membership to their own folders. Try unsharing or
        transferring ownership first.

        mounted: The shared folder is currently mounted.  Unmount the shared
        folder before relinquishing membership.

        group_access: The current user has access to the shared folder via a
        group.  You can't relinquish membership to folders shared via groups.

        team_folder: This action cannot be performed on a team shared folder.

        no_permission: The current user does not have permission to perform this
        action.

        no_explicit_access: The current user only has inherited access to the
        shared folder.  You can't relinquish inherited membership to folders.

        other: None
    ListFolderArg:
      type: object
      properties:
        shared_link:
          $ref: '#/components/schemas/SharedLink'
        include_property_groups:
          $ref: '#/components/schemas/TemplateFilterBase'
        recursive:
          type: boolean
          description: >-
            If true, the list folder operation will be applied recursively to
            all subfolders and the response will contain contents of all
            subfolders.
        include_has_explicit_shared_members:
          type: boolean
          description: >-
            If true, the results will include a flag for each file indicating
            whether or not  that file has any explicit members.
        include_deleted:
          type: boolean
          description: >-
            If true, the results will include entries for files and folders that
            used to exist but were deleted.
        limit:
          type: number
          description: >-
            The maximum number of results to return per request. Note: This is
            an approximate number and there can be slightly more entries
            returned in some cases.
        include_media_info:
          type: boolean
          description: >-
            If true, :field:`FileMetadata.media_info` is set for photo and
            video.
        include_mounted_folders:
          type: boolean
          description: >-
            If true, the results will include entries under mounted folders
            which includes app folder, shared folder and team folder.
        path:
          type: string
          description: A unique identifier for the file.
      description: >
        path: A unique identifier for the file.

        recursive: If true, the list folder operation will be applied
        recursively to all subfolders and the response will contain contents of
        all subfolders.

        include_media_info: If true, :field:`FileMetadata.media_info` is set for
        photo and video.

        include_deleted: If true, the results will include entries for files and
        folders that used to exist but were deleted.

        include_has_explicit_shared_members: If true, the results will include a
        flag for each file indicating whether or not  that file has any explicit
        members.

        include_mounted_folders: If true, the results will include entries under
        mounted folders which includes app folder, shared folder and team
        folder.

        limit: The maximum number of results to return per request. Note: This
        is an approximate number and there can be slightly more entries returned
        in some cases.

        shared_link: A shared link to list the contents of. If the link is
        password-protected, the password must be provided. If this field is
        present, :field:`ListFolderArg.path` will be relative to root of the
        shared link. Only non-recursive mode is supported for shared link.

        include_property_groups: If set to a valid list of template IDs,
        :field:`FileMetadata.property_groups` is set if there exists property
        data associated with the file and each of the listed templates.
    AddPaperDocUser:
      type: object
      properties:
        doc_id:
          type: string
          description: The Paper doc ID.
        quiet:
          type: boolean
          description: >-
            Clients should set this to true if no email message shall be sent to
            added users.
        members:
          type: array
          description: >-
            User which should be added to the Paper doc. Specify only email
            address or Dropbox account ID.
          items:
            $ref: '#/components/schemas/AddMember'
        custom_message:
          type: string
          description: >-
            A personal message that will be emailed to each successfully added
            member.
      description: >
        doc_id: The Paper doc ID.

        members: User which should be added to the Paper doc. Specify only email
        address or Dropbox account ID.

        custom_message: A personal message that will be emailed to each
        successfully added member.

        quiet: Clients should set this to true if no email message shall be sent
        to added users.
    AddMember:
      type: object
      properties:
        member:
          $ref: '#/components/schemas/MemberSelector'
        permission_level:
          $ref: '#/components/schemas/PaperDocPermissionLevel'
      description: >
        member: User which should be added to the Paper doc. Specify only email
        address or Dropbox account ID.

        permission_level: Permission for the user.
    GracePeriod:
      type: object
      properties:
        .tag:
          title: Choice of GracePeriod
          type: string
          enum:
            - one_day
            - two_days
            - seven_days
            - thirty_days
            - always
            - other
      description: |
        one_day: None
        two_days: None
        seven_days: None
        thirty_days: None
        always: None
        other: None
    UserInfoWithPermissionLevel:
      type: object
      properties:
        permission_level:
          $ref: '#/components/schemas/PaperDocPermissionLevel'
        user:
          $ref: '#/components/schemas/UserInfo'
      description: |
        user: User shared on the Paper doc.
        permission_level: Permission level for the user.
    PollError:
      type: object
      properties:
        .tag:
          title: Choice of PollError
          type: string
          enum:
            - invalid_async_job_id
            - internal_error
            - other
      description: >
        Error returned by methods for polling the status of asynchronous job.

        invalid_async_job_id: The job ID is invalid.

        internal_error: Something went wrong with the job on Dropbox's end.
        You'll need to verify that the action you were taking succeeded, and if
        not, try again. This should happen very rarely.

        other: None
    DeleteBatchArg:
      type: object
      properties:
        entries:
          type: array
          items:
            $ref: '#/components/schemas/DeleteArg'
      description: |
        entries: None
    RelinquishFileMembershipError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of RelinquishFileMembershipError
          type: string
          enum:
            - access_error
            - group_access
            - no_permission
            - other
      description: >
        access_error: None

        group_access: The current user has access to the shared file via a
        group.  You can't relinquish membership to a file shared via groups.

        no_permission: The current user does not have permission to perform this
        action.

        other: None
    ListFileMembersBatchArg:
      type: object
      properties:
        files:
          type: array
          description: Files for which to return members.
          items:
            type: string
        limit:
          type: number
          description: >-
            Number of members to return max per query. Defaults to 10 if no
            limit is specified.
      description: >
        Arguments for :route:`list_file_members/batch`.

        files: Files for which to return members.

        limit: Number of members to return max per query. Defaults to 10 if no
        limit is specified.
    GetThumbnailBatchResult:
      type: object
      properties:
        entries:
          type: array
          description: List of files and their thumbnails.
          items:
            $ref: '#/components/schemas/GetThumbnailBatchResultEntry'
      description: |
        entries: List of files and their thumbnails.
    CreateFolderArg:
      type: object
      properties:
        path:
          type: string
          description: Path in the user's Dropbox to create.
        autorename:
          type: boolean
          description: >-
            If there's a conflict, have the Dropbox server try to autorename the
            folder to avoid the conflict.
      description: >
        path: Path in the user's Dropbox to create.

        autorename: If there's a conflict, have the Dropbox server try to
        autorename the folder to avoid the conflict.
    PlatformType:
      type: object
      properties:
        .tag:
          title: Choice of PlatformType
          type: string
          enum:
            - web
            - mobile
            - desktop
            - unknown
            - other
      description: |
        Possible platforms on which a user may view content.
        web: The content was viewed on the web.
        mobile: The content was viewed on a mobile client.
        desktop: The content was viewed on a desktop client.
        unknown: The content was viewed on an unknown platform.
        other: None
    SharedContentLinkMetadata:
      type: object
      properties:
        current_audience:
          $ref: '#/components/schemas/LinkAudience'
        url:
          type: string
          description: The URL of the link.
        password_protected:
          type: boolean
          description: Whether the link is protected by a password.
        audience_exceptions:
          $ref: '#/components/schemas/AudienceExceptions'
        expiry:
          type: string
          description: >-
            Whether the link has an expiry set on it. A link with an expiry will
            have its  audience changed to members when the expiry is reached.
        access_level:
          $ref: '#/components/schemas/AccessLevel'
        audience_restricting_shared_folder:
          $ref: '#/components/schemas/AudienceRestrictingSharedFolder'
        link_permissions:
          type: array
          description: A list of permissions for actions you can perform on the link.
          items:
            $ref: '#/components/schemas/LinkPermission'
        audience_options:
          type: array
          description: >-
            The audience options that are available for the content. Some
            audience options may be unavailable. For example, team_only may be
            unavailable if the content is not owned by a user on a team. The
            'default' audience option is always available if the user can modify
            link settings.
          items:
            $ref: '#/components/schemas/LinkAudience'
      description: >
        Metadata of a shared link for a file or folder.

        audience_options: The audience options that are available for the
        content. Some audience options may be unavailable. For example,
        team_only may be unavailable if the content is not owned by a user on a
        team. The 'default' audience option is always available if the user can
        modify link settings.

        current_audience: The current audience of the link.

        link_permissions: A list of permissions for actions you can perform on
        the link.

        password_protected: Whether the link is protected by a password.

        url: The URL of the link.

        access_level: The access level on the link for this file.

        audience_restricting_shared_folder: The shared folder that prevents the
        link audience for this link from being more restrictive.

        expiry: Whether the link has an expiry set on it. A link with an expiry
        will have its  audience changed to members when the expiry is reached.

        audience_exceptions: The content inside this folder with link audience
        different than this folder's. This is only returned when an endpoint
        that returns metadata for a single shared folder is called, e.g.
        /get_folder_metadata.
    InviteeMembershipInfo:
      type: object
      properties:
        invitee:
          $ref: '#/components/schemas/InviteeInfo'
        access_type:
          $ref: '#/components/schemas/AccessLevel'
        user:
          $ref: '#/components/schemas/UserInfo'
        is_inherited:
          type: boolean
          description: True if the member has access from a parent folder.
        initials:
          type: string
          description: Never set.
        permissions:
          type: array
          description: >-
            The permissions that requesting user has on this member. The set of
            permissions corresponds to the MemberActions in the request.
          items:
            $ref: '#/components/schemas/MemberPermission'
      description: >
        Information about an invited member of a shared content.

        access_type: The access type for this member.

        invitee: Recipient of the invitation.

        permissions: The permissions that requesting user has on this member.
        The set of permissions corresponds to the MemberActions in the request.

        initials: Never set.

        is_inherited: True if the member has access from a parent folder.

        user: The user this invitation is tied to, if available.
    GetAccountError:
      type: object
      properties:
        .tag:
          title: Choice of GetAccountError
          type: string
          enum:
            - no_account
            - other
      description: >
        no_account: The specified :field:`GetAccountArg.account_id` does not
        exist.

        other: None
    JobStatus:
      type: object
      properties:
        failed:
          $ref: '#/components/schemas/JobError'
        .tag:
          title: Choice of JobStatus
          type: string
          enum:
            - in_progress
            - complete
            - failed
      description: |
        in_progress: The asynchronous job is still in progress.
        complete: The asynchronous job has finished.
        failed: The asynchronous job returned an error.
    WriteConflictError:
      type: object
      properties:
        .tag:
          title: Choice of WriteConflictError
          type: string
          enum:
            - file
            - folder
            - file_ancestor
            - other
      description: >
        file: There's a file in the way.

        folder: There's a folder in the way.

        file_ancestor: There's a file at an ancestor path, so we couldn't create
        the required parent folders.

        other: None
    LinkPermission:
      type: object
      properties:
        action:
          $ref: '#/components/schemas/LinkAction'
        reason:
          $ref: '#/components/schemas/PermissionDeniedReason'
        allow:
          type: boolean
      description: |
        Permissions for actions that can be performed on a link.
        action: None
        allow: None
        reason: None
    Team:
      type: object
      properties:
        id:
          type: string
          description: The team's unique ID.
        name:
          type: string
          description: The name of the team.
      description: |
        Information about a team.
        id: The team's unique ID.
        name: The name of the team.
    SaveUrlResult:
      type: object
      properties:
        .tag:
          title: Choice of SaveUrlResult
          type: string
          enum:
            - async_job_id
            - complete
        async_job_id:
          type: string
          description: >-
            This response indicates that the processing is asynchronous. The
            string is an id that can be used to obtain the status of the
            asynchronous job.
        complete:
          $ref: '#/components/schemas/FileMetadata'
      description: >
        async_job_id: This response indicates that the processing is
        asynchronous. The string is an id that can be used to obtain the status
        of the asynchronous job.

        complete: Metadata of the file where the URL is saved to.
    SetAccessInheritanceArg:
      type: object
      properties:
        access_inheritance:
          $ref: '#/components/schemas/AccessInheritance'
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
      description: |
        shared_folder_id: The ID for the shared folder.
        access_inheritance: The access inheritance settings for the folder.
    ListFolderLongpollError:
      type: object
      properties:
        .tag:
          title: Choice of ListFolderLongpollError
          type: string
          enum:
            - reset
            - other
      description: >
        reset: Indicates that the cursor has been invalidated. Call
        :route:`list_folder` to obtain a new cursor.

        other: None
    ListFilesResult:
      type: object
      properties:
        cursor:
          type: string
          description: Cursor used to obtain additional shared files.
        entries:
          type: array
          description: Information about the files shared with current user.
          items:
            $ref: '#/components/schemas/SharedFileMetadata'
      description: |
        Success results for :route:`list_received_files`.
        entries: Information about the files shared with current user.
        cursor: Cursor used to obtain additional shared files.
    CreateSharedLinkWithSettingsArg:
      type: object
      properties:
        path:
          type: string
          description: The path to be shared by the shared link.
        settings:
          $ref: '#/components/schemas/SharedLinkSettings'
      description: |
        path: The path to be shared by the shared link.
        settings: The requested settings for the newly created shared link.
    ModifyTemplateError:
      type: object
      properties:
        .tag:
          title: Choice of ModifyTemplateError
          type: string
          enum:
            - template_not_found
            - restricted_content
            - other
            - conflicting_property_names
            - too_many_properties
            - too_many_templates
            - template_attribute_too_large
        template_not_found:
          type: string
          description: Template does not exist for the given identifier.
      description: >
        template_not_found: Template does not exist for the given identifier.

        restricted_content: You do not have permission to modify this template.

        other: None

        conflicting_property_names: A property field key with that 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 one or
        more of the property field keys is too large.
    GetFileMetadataBatchArg:
      type: object
      properties:
        files:
          type: array
          description: The files to query.
          items:
            type: string
        actions:
          type: array
          description: >-
            A list of `FileAction`s corresponding to `FilePermission`s that
            should appear in the  response's
            :field:`SharedFileMetadata.permissions` field describing the actions
            the  authenticated user can perform on the file.
          items:
            $ref: '#/components/schemas/FileAction'
      description: >
        Arguments of :route:`get_file_metadata/batch`.

        files: The files to query.

        actions: A list of `FileAction`s corresponding to `FilePermission`s that
        should appear in the  response's :field:`SharedFileMetadata.permissions`
        field describing the actions the  authenticated user can perform on the
        file.
    PropertiesSearchContinueArg:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            The cursor returned by your last call to :route:`properties/search`
            or :route:`properties/search/continue`.
      description: >
        cursor: The cursor returned by your last call to
        :route:`properties/search` or :route:`properties/search/continue`.
    GetFileMetadataArg:
      type: object
      properties:
        actions:
          type: array
          description: >-
            A list of `FileAction`s corresponding to `FilePermission`s that
            should appear in the  response's
            :field:`SharedFileMetadata.permissions` field describing the actions
            the  authenticated user can perform on the file.
          items:
            $ref: '#/components/schemas/FileAction'
        file:
          type: string
          description: The file to query.
      description: >
        Arguments of :route:`get_file_metadata`.

        file: The file to query.

        actions: A list of `FileAction`s corresponding to `FilePermission`s that
        should appear in the  response's :field:`SharedFileMetadata.permissions`
        field describing the actions the  authenticated user can perform on the
        file.
    AddFolderMemberArg:
      type: object
      properties:
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
        quiet:
          type: boolean
          description: >-
            Whether added members should be notified via email and device
            notifications of their invite.
        members:
          type: array
          description: >-
            The intended list of members to add.  Added members will receive
            invites to join the shared folder.
          items:
            $ref: '#/components/schemas/AddMember'
        custom_message:
          type: string
          description: Optional message to display to added members in their invitation.
      description: >
        shared_folder_id: The ID for the shared folder.

        members: The intended list of members to add.  Added members will
        receive invites to join the shared folder.

        quiet: Whether added members should be notified via email and device
        notifications of their invite.

        custom_message: Optional message to display to added members in their
        invitation.
    UpdateFileMemberArgs:
      type: object
      properties:
        member:
          $ref: '#/components/schemas/MemberSelector'
        access_level:
          $ref: '#/components/schemas/AccessLevel'
        file:
          type: string
          description: File for which we are changing a member's access.
      description: |
        Arguments for :route:`update_file_member`.
        file: File for which we are changing a member's access.
        member: The member whose access we are changing.
        access_level: The new access level for the member.
    SpaceUsage:
      type: object
      properties:
        allocation:
          $ref: '#/components/schemas/SpaceAllocation'
        used:
          type: number
          description: The user's total space usage (bytes).
      description: |
        Information about a user's space usage and quota.
        used: The user's total space usage (bytes).
        allocation: The user's space allocation.
    CreateFolderBatchResultEntry:
      type: object
      properties:
        failure:
          $ref: '#/components/schemas/CreateFolderEntryError'
        .tag:
          title: Choice of CreateFolderBatchResultEntry
          type: string
          enum:
            - success
            - failure
        success:
          $ref: '#/components/schemas/CreateFolderEntryResult'
      description: |
        success: None
        failure: None
    UpdateFolderMemberError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of UpdateFolderMemberError
          type: string
          enum:
            - access_error
            - member_error
            - no_explicit_access
            - insufficient_plan
            - no_permission
            - other
        no_explicit_access:
          $ref: '#/components/schemas/AddFolderMemberError'
        member_error:
          $ref: '#/components/schemas/SharedFolderMemberError'
      description: >
        access_error: None

        member_error: None

        no_explicit_access: If updating the access type required the member to
        be added to the shared folder and there was an error when adding the
        member.

        insufficient_plan: The current user's account doesn't support this
        action. An example of this is when downgrading a member from editor to
        viewer. This action can only be performed by users that have upgraded to
        a Pro or Business plan.

        no_permission: The current user does not have permission to perform this
        action.

        other: None
    PaperDocExportResult:
      type: object
      properties:
        owner:
          type: string
          description: The Paper doc owner's email address.
        revision:
          type: number
          description: The Paper doc revision. Simply an ever increasing number.
        mime_type:
          type: string
          description: >-
            MIME type of the export. This corresponds to :type:`ExportFormat`
            specified in the request.
        title:
          type: string
          description: The Paper doc title.
      description: >
        owner: The Paper doc owner's email address.

        title: The Paper doc title.

        revision: The Paper doc revision. Simply an ever increasing number.

        mime_type: MIME type of the export. This corresponds to
        :type:`ExportFormat` specified in the request.
    DeleteBatchError:
      type: object
      properties:
        .tag:
          title: Choice of DeleteBatchError
          type: string
          enum:
            - too_many_write_operations
            - other
      description: >
        too_many_write_operations: Use
        :field:`DeleteError.too_many_write_operations`. :route:`delete_batch`
        now provides smaller granularity about which entry has failed because of
        this.

        other: None
    UserFileMembershipInfo:
      type: object
      properties:
        access_type:
          $ref: '#/components/schemas/AccessLevel'
        platform_type:
          $ref: '#/components/schemas/PlatformType'
        user:
          $ref: '#/components/schemas/UserInfo'
        time_last_seen:
          type: string
          description: >-
            The UTC timestamp of when the user has last seen the content, if
            they have.
        is_inherited:
          type: boolean
          description: True if the member has access from a parent folder.
        permissions:
          type: array
          description: >-
            The permissions that requesting user has on this member. The set of
            permissions corresponds to the MemberActions in the request.
          items:
            $ref: '#/components/schemas/MemberPermission'
        initials:
          type: string
          description: Never set.
      description: >
        The information about a user member of the shared content with an
        appended last seen timestamp.

        access_type: The access type for this member.

        user: The account information for the membership user.

        permissions: The permissions that requesting user has on this member.
        The set of permissions corresponds to the MemberActions in the request.

        initials: Never set.

        is_inherited: True if the member has access from a parent folder.

        time_last_seen: The UTC timestamp of when the user has last seen the
        content, if they have.

        platform_type: The platform on which the user has last seen the content,
        or unknown.
    MemberAccessLevelResult:
      type: object
      properties:
        access_level:
          $ref: '#/components/schemas/AccessLevel'
        access_details:
          type: array
          description: >-
            The parent folders that a member has access to. The field is present
            if the user has access to the first parent folder where the member
            gains access.
          items:
            $ref: '#/components/schemas/ParentFolderAccessInfo'
        warning:
          type: string
          description: >-
            A localized string with additional information about why the user
            has this access level to the content.
      description: >
        Contains information about a member's access level to content after an
        operation.

        access_level: The member still has this level of access to the content
        through a parent folder.

        warning: A localized string with additional information about why the
        user has this access level to the content.

        access_details: The parent folders that a member has access to. The
        field is present if the user has access to the first parent folder where
        the member gains access.
    JobError:
      type: object
      properties:
        remove_folder_member_error:
          $ref: '#/components/schemas/RemoveFolderMemberError'
        unshare_folder_error:
          $ref: '#/components/schemas/UnshareFolderError'
        .tag:
          title: Choice of JobError
          type: string
          enum:
            - unshare_folder_error
            - remove_folder_member_error
            - relinquish_folder_membership_error
            - other
        relinquish_folder_membership_error:
          $ref: '#/components/schemas/RelinquishFolderMembershipError'
      description: >
        Error occurred while performing an asynchronous job from
        :route:`unshare_folder` or :route:`remove_folder_member`.

        unshare_folder_error: Error occurred while performing
        :route:`unshare_folder` action.

        remove_folder_member_error: Error occurred while performing
        :route:`remove_folder_member` action.

        relinquish_folder_membership_error: Error occurred while performing
        :route:`relinquish_folder_membership` action.

        other: None
    PreviewError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of PreviewError
          type: string
          enum:
            - path
            - in_progress
            - unsupported_extension
            - unsupported_content
      description: >
        path: An error occurs when downloading metadata for the file.

        in_progress: This preview generation is still in progress and the file
        is not ready  for preview yet.

        unsupported_extension: The file extension is not supported preview
        generation.

        unsupported_content: The file content is not supported for preview
        generation.
    CreateFileRequestError:
      type: object
      properties:
        .tag:
          title: Choice of CreateFileRequestError
          type: string
          enum:
            - disabled_for_team
            - other
            - not_found
            - not_a_folder
            - app_lacks_access
            - no_permission
            - email_unverified
            - validation_error
            - invalid_location
            - rate_limit
      description: >
        There was an error creating the file request.

        disabled_for_team: This user's Dropbox Business team doesn't allow file
        requests.

        other: None

        not_found: This file request ID was not found.

        not_a_folder: The specified path is not a folder.

        app_lacks_access: This file request is not accessible to this app. Apps
        with the app folder permission can only access file requests in their
        app folder.

        no_permission: This user doesn't have permission to access or modify
        this file request.

        email_unverified: This user's email address is not verified. File
        requests are only available on accounts with a verified email address.
        Users can verify their email address :link:`here
        https://www.dropbox.com/help/317`.

        validation_error: There was an error validating the request. For
        example, the title was invalid, or there were disallowed characters in
        the destination path.

        invalid_location: 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.
    SharingTeamPolicyType:
      type: object
      properties:
        .tag:
          title: Choice of SharingTeamPolicyType
          type: string
          enum:
            - people_with_link_can_edit
            - people_with_link_can_view_and_comment
            - invite_only
      description: >
        The sharing policy type of the Paper doc.

        people_with_link_can_edit: Users who have a link to this doc can edit
        it.

        people_with_link_can_view_and_comment: Users who have a link to this doc
        can view and comment on it.

        invite_only: Users must be explicitly invited to this doc.
    ThumbnailSize:
      type: object
      properties:
        .tag:
          title: Choice of ThumbnailSize
          type: string
          enum:
            - w32h32
            - w64h64
            - w128h128
            - w256h256
            - w480h320
            - w640h480
            - w960h640
            - w1024h768
            - w2048h1536
      description: |
        w32h32: 32 by 32 px.
        w64h64: 64 by 64 px.
        w128h128: 128 by 128 px.
        w256h256: 256 by 256 px.
        w480h320: 480 by 320 px.
        w640h480: 640 by 480 px.
        w960h640: 960 by 640 px.
        w1024h768: 1024 by 768 px.
        w2048h1536: 2048 by 1536 px.
    UpdatePropertiesArg:
      type: object
      properties:
        path:
          type: string
          description: A unique identifier for the file or folder.
        update_property_groups:
          type: array
          description: The property groups "delta" updates to apply.
          items:
            $ref: '#/components/schemas/PropertyGroupUpdate'
      description: |
        path: A unique identifier for the file or folder.
        update_property_groups: The property groups "delta" updates to apply.
    GetThumbnailBatchArg:
      type: object
      properties:
        entries:
          type: array
          description: List of files to get thumbnails.
          items:
            $ref: '#/components/schemas/ThumbnailArg'
      description: |
        Arguments for :route:`get_thumbnail_batch`.
        entries: List of files to get thumbnails.
    AddFileMemberError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of AddFileMemberError
          type: string
          enum:
            - user_error
            - access_error
            - rate_limit
            - invalid_comment
            - other
        user_error:
          $ref: '#/components/schemas/SharingUserError'
      description: >
        Errors for :route:`add_file_member`.

        user_error: None

        access_error: None

        rate_limit: The user has reached the rate limit for invitations.

        invalid_comment: The custom message did not pass comment permissions
        checks.

        other: None
    RelocationBatchArg:
      type: object
      properties:
        allow_ownership_transfer:
          type: boolean
          description: >-
            Allow moves by owner even if it would result in an ownership
            transfer for the content being moved. This does not apply to copies.
        allow_shared_folder:
          type: boolean
          description: >-
            If true, :route:`copy_batch` will copy contents in shared folder,
            otherwise :field:`RelocationError.cant_copy_shared_folder` will be
            returned if :field:`RelocationPath.from_path` contains shared
            folder.  This field is always true for :route:`move_batch`.
        autorename:
          type: boolean
          description: >-
            If there's a conflict with any file, have the Dropbox server try to
            autorename that file to avoid the conflict.
        entries:
          type: array
          description: >-
            List of entries to be moved or copied. Each entry is
            :type:`RelocationPath`.
          items:
            $ref: '#/components/schemas/RelocationPath'
      description: >
        entries: List of entries to be moved or copied. Each entry is
        :type:`RelocationPath`.

        allow_shared_folder: If true, :route:`copy_batch` will copy contents in
        shared folder, otherwise
        :field:`RelocationError.cant_copy_shared_folder` will be returned if
        :field:`RelocationPath.from_path` contains shared folder.  This field is
        always true for :route:`move_batch`.

        autorename: If there's a conflict with any file, have the Dropbox server
        try to autorename that file to avoid the conflict.

        allow_ownership_transfer: Allow moves by owner even if it would result
        in an ownership transfer for the content being moved. This does not
        apply to copies.
    CreateFolderBatchResult:
      type: object
      properties:
        entries:
          type: array
          items:
            $ref: '#/components/schemas/CreateFolderBatchResultEntry'
      description: |
        entries: None
    GetSharedLinksArg:
      type: object
      properties:
        path:
          type: string
          description: See :route:`get_shared_links` description.
      description: |
        path: See :route:`get_shared_links` description.
    ListFolderMembersArgs:
      type: object
      properties:
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
        limit:
          type: number
          description: >-
            The maximum number of results that include members, groups and
            invitees to return per request.
        actions:
          type: array
          description: >-
            This is a list indicating whether each returned member will include
            a boolean value :field:`MemberPermission.allow` that describes
            whether the current user can perform the MemberAction on the member.
          items:
            $ref: '#/components/schemas/MemberAction'
      description: >
        shared_folder_id: The ID for the shared folder.

        actions: This is a list indicating whether each returned member will
        include a boolean value :field:`MemberPermission.allow` that describes
        whether the current user can perform the MemberAction on the member.

        limit: The maximum number of results that include members, groups and
        invitees to return per request.
    SaveCopyReferenceArg:
      type: object
      properties:
        path:
          type: string
          description: Path in the user's Dropbox that is the destination.
        copy_reference:
          type: string
          description: A copy reference returned by :route:`copy_reference/get`.
      description: >
        copy_reference: A copy reference returned by
        :route:`copy_reference/get`.

        path: Path in the user's Dropbox that is the destination.
    PropertiesSearchContinueError:
      type: object
      properties:
        .tag:
          title: Choice of PropertiesSearchContinueError
          type: string
          enum:
            - reset
            - other
      description: >
        reset: Indicates that the cursor has been invalidated. Call
        :route:`properties/search` to obtain a new cursor.

        other: None
    RemoveFolderMemberArg:
      type: object
      properties:
        member:
          $ref: '#/components/schemas/MemberSelector'
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
        leave_a_copy:
          type: boolean
          description: >-
            If true, the removed user will keep their copy of the folder after
            it's unshared, assuming it was mounted. Otherwise, it will be
            removed from their Dropbox. Also, this must be set to false when
            kicking a group.
      description: >
        shared_folder_id: The ID for the shared folder.

        member: The member to remove from the folder.

        leave_a_copy: If true, the removed user will keep their copy of the
        folder after it's unshared, assuming it was mounted. Otherwise, it will
        be removed from their Dropbox. Also, this must be set to false when
        kicking a group.
    TokenFromOAuth1Error:
      type: object
      properties:
        .tag:
          title: Choice of TokenFromOAuth1Error
          type: string
          enum:
            - invalid_oauth1_token_info
            - app_id_mismatch
            - other
      description: >
        invalid_oauth1_token_info: Part or all of the OAuth 1.0 access token
        info is invalid.

        app_id_mismatch: The authorized app does not match the app associated
        with the supplied access token.

        other: None
    PaperApiCursorError:
      type: object
      properties:
        .tag:
          title: Choice of PaperApiCursorError
          type: string
          enum:
            - expired_cursor
            - invalid_cursor
            - wrong_user_in_cursor
            - reset
            - other
      description: >
        expired_cursor: The provided cursor is expired.

        invalid_cursor: The provided cursor is invalid.

        wrong_user_in_cursor: The provided cursor contains invalid user.

        reset: Indicates that the cursor has been invalidated. Call the
        corresponding non-continue endpoint to obtain a new cursor.

        other: None
    GetMetadataArgs:
      type: object
      properties:
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
        actions:
          type: array
          description: >-
            A list of `FolderAction`s corresponding to `FolderPermission`s that
            should appear in the  response's
            :field:`SharedFolderMetadata.permissions` field describing the
            actions the  authenticated user can perform on the folder.
          items:
            $ref: '#/components/schemas/FolderAction'
      description: >
        shared_folder_id: The ID for the shared folder.

        actions: A list of `FolderAction`s corresponding to `FolderPermission`s
        that should appear in the  response's
        :field:`SharedFolderMetadata.permissions` field describing the actions
        the  authenticated user can perform on the folder.
    GetThumbnailBatchResultData:
      type: object
      properties:
        thumbnail:
          type: string
        metadata:
          $ref: '#/components/schemas/FileMetadata'
      description: |
        metadata: None
        thumbnail: None
    ListFolderGetLatestCursorResult:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            Pass the cursor into :route:`list_folder/continue` to see what's
            changed in the folder since your previous query.
      description: >
        cursor: Pass the cursor into :route:`list_folder/continue` to see what's
        changed in the folder since your previous query.
    PermissionDeniedReason:
      type: object
      properties:
        insufficient_plan:
          $ref: '#/components/schemas/InsufficientPlan'
        .tag:
          title: Choice of PermissionDeniedReason
          type: string
          enum:
            - user_not_same_team_as_owner
            - user_not_allowed_by_owner
            - target_is_indirect_member
            - target_is_owner
            - target_is_self
            - target_not_active
            - folder_is_limited_team_folder
            - owner_not_on_team
            - permission_denied
            - restricted_by_team
            - user_account_type
            - user_not_on_team
            - folder_is_inside_shared_folder
            - restricted_by_parent_folder
            - insufficient_plan
            - other
      description: >
        Possible reasons the user is denied a permission.

        user_not_same_team_as_owner: User is not on the same team as the folder
        owner.

        user_not_allowed_by_owner: User is prohibited by the owner from taking
        the action.

        target_is_indirect_member: Target is indirectly a member of the folder,
        for example by being part of a group.

        target_is_owner: Target is the owner of the folder.

        target_is_self: Target is the user itself.

        target_not_active: Target is not an active member of the team.

        folder_is_limited_team_folder: Folder is team folder for a limited team.

        owner_not_on_team: The content owner needs to be on a Dropbox team to
        perform this action.

        permission_denied: The user does not have permission to perform this
        action on the link.

        restricted_by_team: The user's team policy prevents performing this
        action on the link.

        user_account_type: The user's account type does not support this action.

        user_not_on_team: The user needs to be on a Dropbox team to perform this
        action.

        folder_is_inside_shared_folder: Folder is inside of another shared
        folder.

        restricted_by_parent_folder: Policy cannot be changed due to
        restrictions from parent folder.

        insufficient_plan: None

        other: None
    UploadSessionFinishBatchJobStatus:
      type: object
      properties:
        .tag:
          title: Choice of UploadSessionFinishBatchJobStatus
          type: string
          enum:
            - in_progress
            - complete
        complete:
          $ref: '#/components/schemas/UploadSessionFinishBatchResult'
      description: |
        in_progress: The asynchronous job is still in progress.
        complete: The :route:`upload_session/finish_batch` has finished.
    SharedLinkCreatePolicy:
      type: object
      properties:
        .tag:
          title: Choice of SharedLinkCreatePolicy
          type: string
          enum:
            - default_public
            - default_team_only
            - team_only
            - other
      description: >
        Policy governing the visibility of shared links. This policy can apply
        to newly created shared links, or all shared links.

        default_public: By default, anyone can access newly created shared
        links. No login will be required to access the shared links unless
        overridden.

        default_team_only: By default, only members of the same team can access
        newly created shared links. Login will be required to access the shared
        links unless overridden.

        team_only: Only members of the same team can access all shared links.
        Login will be required to access all shared links.

        other: None
    ImportFormat:
      type: object
      properties:
        .tag:
          title: Choice of ImportFormat
          type: string
          enum:
            - html
            - markdown
            - plain_text
            - other
      description: >
        The import format of the incoming data.

        html: The provided data is interpreted as standard HTML.

        markdown: The provided data is interpreted as markdown.

        Note: The first line of the provided document will be used as the doc
        title.

        plain_text: The provided data is interpreted as plain text.

        Note: The first line of the provided document will be used as the doc
        title.

        other: None
    MemberSelector:
      type: object
      properties:
        .tag:
          title: Choice of MemberSelector
          type: string
          enum:
            - dropbox_id
            - email
            - other
        dropbox_id:
          type: string
          description: Dropbox account, team member, or group ID of member.
        email:
          type: string
          description: E-mail address of member.
      description: |
        Includes different ways to identify a member of a shared folder.
        dropbox_id: Dropbox account, team member, or group ID of member.
        email: E-mail address of member.
        other: None
    RelocationBatchLaunch:
      type: object
      properties:
        .tag:
          title: Choice of RelocationBatchLaunch
          type: string
          enum:
            - async_job_id
            - complete
            - other
        async_job_id:
          type: string
          description: >-
            This response indicates that the processing is asynchronous. The
            string is an id that can be used to obtain the status of the
            asynchronous job.
        complete:
          $ref: '#/components/schemas/RelocationBatchResult'
      description: >
        Result returned by :route:`copy_batch` or :route:`move_batch` that may
        either launch an asynchronous job or complete synchronously.

        async_job_id: This response indicates that the processing is
        asynchronous. The string is an id that can be used to obtain the status
        of the asynchronous job.

        complete: None

        other: None
    GetFileMetadataBatchResult:
      type: object
      properties:
        result:
          $ref: '#/components/schemas/GetFileMetadataIndividualResult'
        file:
          type: string
          description: >-
            This is the input file identifier corresponding to one of
            :field:`GetFileMetadataBatchArg.files`.
      description: >
        Per file results of :route:`get_file_metadata/batch`.

        file: This is the input file identifier corresponding to one of
        :field:`GetFileMetadataBatchArg.files`.

        result: The result for this particular file.
    ListFilesContinueArg:
      type: object
      properties:
        cursor:
          type: string
          description: Cursor in :field:`ListFilesResult.cursor`.
      description: |
        Arguments for :route:`list_received_files/continue`.
        cursor: Cursor in :field:`ListFilesResult.cursor`.
    ListDocsCursorError:
      type: object
      properties:
        cursor_error:
          $ref: '#/components/schemas/PaperApiCursorError'
        .tag:
          title: Choice of ListDocsCursorError
          type: string
          enum:
            - cursor_error
            - other
      description: |
        cursor_error: None
        other: None
    FileMemberActionError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of FileMemberActionError
          type: string
          enum:
            - invalid_member
            - no_permission
            - access_error
            - no_explicit_access
            - other
        no_explicit_access:
          $ref: '#/components/schemas/MemberAccessLevelResult'
      description: >
        invalid_member: Specified member was not found.

        no_permission: User does not have permission to perform this action on
        this member.

        access_error: Specified file was invalid or user does not have access.

        no_explicit_access: The action cannot be completed because the target
        member does not have explicit access to the file. The return value is
        the access that the member has to the file from a parent folder.

        other: None
    TemplateFilter:
      type: object
      properties:
        filter_some:
          type: array
          description: >-
            Only templates with an ID in the supplied list will be returned (a
            subset of templates will be returned).
          items:
            type: string
        .tag:
          title: Choice of TemplateFilter
          type: string
          enum:
            - filter_some
            - other
            - filter_none
      description: >
        filter_some: Only templates with an ID in the supplied list will be
        returned (a subset of templates will be returned).

        other: None

        filter_none: No templates will be filtered from the result (all
        templates will be returned).
    SetAccessInheritanceError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of SetAccessInheritanceError
          type: string
          enum:
            - access_error
            - no_permission
            - other
      description: >
        access_error: Unable to access shared folder.

        no_permission: The current user does not have permission to perform this
        action.

        other: None
    ListFoldersContinueError:
      type: object
      properties:
        .tag:
          title: Choice of ListFoldersContinueError
          type: string
          enum:
            - invalid_cursor
            - other
      description: |
        invalid_cursor: :field:`ListFoldersContinueArg.cursor` is invalid.
        other: None
    AddPropertiesArg:
      type: object
      properties:
        path:
          type: string
          description: A unique identifier for the file or folder.
        property_groups:
          type: array
          description: The property groups which are to be added to a Dropbox file.
          items:
            $ref: '#/components/schemas/PropertyGroup'
      description: >
        path: A unique identifier for the file or folder.

        property_groups: The property groups which are to be added to a Dropbox
        file.
    MediaInfo:
      type: object
      properties:
        .tag:
          title: Choice of MediaInfo
          type: string
          enum:
            - pending
            - metadata
        metadata:
          $ref: '#/components/schemas/MediaMetadata'
      description: >
        pending: Indicate the photo/video is still under processing and metadata
        is not available yet.

        metadata: The metadata for the photo/video.
    LinkPermissions:
      type: object
      properties:
        requested_visibility:
          $ref: '#/components/schemas/RequestedVisibility'
        resolved_visibility:
          $ref: '#/components/schemas/ResolvedVisibility'
        can_revoke:
          type: boolean
          description: Whether the caller can revoke the shared link.
        revoke_failure_reason:
          $ref: '#/components/schemas/SharedLinkAccessFailureReason'
      description: >
        can_revoke: Whether the caller can revoke the shared link.

        resolved_visibility: The current visibility of the link after
        considering the shared links policies of the the team (in case the
        link's owner is part of a team) and the shared folder (in case the
        linked file is part of a shared folder). This field is shown only if the
        caller has access to this info (the link's owner always has access to
        this data).

        requested_visibility: The shared link's requested visibility. This can
        be overridden by the team and shared folder policies. The final
        visibility, after considering these policies, can be found in
        :field:`resolved_visibility`. This is shown only if the caller is the
        link's owner.

        revoke_failure_reason: The failure reason for revoking the link. This
        field will only be present if the :field:`can_revoke` is :val:`false`.
    DeleteBatchResultEntry:
      type: object
      properties:
        failure:
          $ref: '#/components/schemas/DeleteError'
        .tag:
          title: Choice of DeleteBatchResultEntry
          type: string
          enum:
            - success
            - failure
        success:
          $ref: '#/components/schemas/DeleteBatchResultData'
      description: |
        success: None
        failure: None
    PropertyGroup:
      type: object
      properties:
        fields:
          type: array
          description: >-
            The actual properties associated with the template. There can be up
            to 32 property types per template.
          items:
            $ref: '#/components/schemas/PropertyField'
        template_id:
          type: string
          description: A unique identifier for the associated template.
      description: >
        A subset of the property fields described by the corresponding
        :type:`PropertyGroupTemplate`. Properties are always added to a Dropbox
        file as a :type:`PropertyGroup`. The possible key names and value types
        in this group are defined by the corresponding
        :type:`PropertyGroupTemplate`.

        template_id: A unique identifier for the associated template.

        fields: The actual properties associated with the template. There can be
        up to 32 property types per template.
    CreateFolderBatchLaunch:
      type: object
      properties:
        .tag:
          title: Choice of CreateFolderBatchLaunch
          type: string
          enum:
            - async_job_id
            - complete
            - other
        async_job_id:
          type: string
          description: >-
            This response indicates that the processing is asynchronous. The
            string is an id that can be used to obtain the status of the
            asynchronous job.
        complete:
          $ref: '#/components/schemas/CreateFolderBatchResult'
      description: >
        Result returned by :route:`create_folder_batch` that may either launch
        an asynchronous job or complete synchronously.

        async_job_id: This response indicates that the processing is
        asynchronous. The string is an id that can be used to obtain the status
        of the asynchronous job.

        complete: None

        other: None
    ListUsersOnFolderContinueArgs:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            The cursor obtained from :route:`docs/folder_users/list` or
            :route:`docs/folder_users/list/continue`. Allows for pagination.
        doc_id:
          type: string
          description: The Paper doc ID.
      description: >
        doc_id: The Paper doc ID.

        cursor: The cursor obtained from :route:`docs/folder_users/list` or
        :route:`docs/folder_users/list/continue`. Allows for pagination.
    RelocationBatchError:
      type: object
      properties:
        to:
          $ref: '#/components/schemas/WriteError'
        from_lookup:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of RelocationBatchError
          type: string
          enum:
            - from_lookup
            - from_write
            - to
            - cant_copy_shared_folder
            - cant_nest_shared_folder
            - cant_move_folder_into_itself
            - too_many_files
            - duplicated_or_nested_paths
            - cant_transfer_ownership
            - insufficient_quota
            - other
            - too_many_write_operations
        from_write:
          $ref: '#/components/schemas/WriteError'
      description: >
        from_lookup: None

        from_write: None

        to: None

        cant_copy_shared_folder: Shared folders can't be copied.

        cant_nest_shared_folder: Your move operation would result in nested
        shared folders.  This is not allowed.

        cant_move_folder_into_itself: You cannot move a folder into itself.

        too_many_files: The operation would involve more than 10,000 files and
        folders.

        duplicated_or_nested_paths: There are duplicated/nested paths among
        :field:`RelocationArg.from_path` and :field:`RelocationArg.to_path`.

        cant_transfer_ownership: Your move operation would result in an
        ownership transfer. You may reissue the request with the field
        :field:`RelocationArg.allow_ownership_transfer` to true.

        insufficient_quota: The current user does not have enough space to move
        or copy the files.

        other: None

        too_many_write_operations: There are too many write operations in user's
        Dropbox. Please retry this request.
    UnshareFileError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of UnshareFileError
          type: string
          enum:
            - user_error
            - access_error
            - other
        user_error:
          $ref: '#/components/schemas/SharingUserError'
      description: |
        Error result for :route:`unshare_file`.
        user_error: None
        access_error: None
        other: None
    SearchMatchType:
      type: object
      properties:
        .tag:
          title: Choice of SearchMatchType
          type: string
          enum:
            - filename
            - content
            - both
      description: >
        Indicates what type of match was found for a given item.

        filename: This item was matched on its file or folder name.

        content: This item was matched based on its file contents.

        both: This item was matched based on both its contents and its file
        name.
    SharedFileMembers:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            Present if there are additional shared file members that have not
            been returned yet. Pass the cursor into
            :route:`list_file_members/continue` to list additional members.
        users:
          type: array
          description: The list of user members of the shared file.
          items:
            $ref: '#/components/schemas/UserFileMembershipInfo'
        groups:
          type: array
          description: The list of group members of the shared file.
          items:
            $ref: '#/components/schemas/GroupMembershipInfo'
        invitees:
          type: array
          description: >-
            The list of invited members of a file, but have not logged in and
            claimed this.
          items:
            $ref: '#/components/schemas/InviteeMembershipInfo'
      description: >
        Shared file user, group, and invitee membership.

        Used for the results of :route:`list_file_members` and
        :route:`list_file_members/continue`, and used as part of the results for
        :route:`list_file_members/batch`.

        users: The list of user members of the shared file.

        groups: The list of group members of the shared file.

        invitees: The list of invited members of a file, but have not logged in
        and claimed this.

        cursor: Present if there are additional shared file members that have
        not been returned yet. Pass the cursor into
        :route:`list_file_members/continue` to list additional members.
    WriteError:
      type: object
      properties:
        malformed_path:
          type: string
        .tag:
          title: Choice of WriteError
          type: string
          enum:
            - malformed_path
            - conflict
            - no_write_permission
            - insufficient_space
            - disallowed_name
            - team_folder
            - too_many_write_operations
            - other
        conflict:
          $ref: '#/components/schemas/WriteConflictError'
      description: >
        malformed_path: None

        conflict: Couldn't write to the target path because there was something
        in the way.

        no_write_permission: The user doesn't have permissions to write to the
        target location.

        insufficient_space: The user doesn't have enough available space (bytes)
        to write more data.

        disallowed_name: Dropbox will not save the file or folder because of its
        name.

        team_folder: This endpoint cannot move or delete team folders.

        too_many_write_operations: There are too many write operations in user's
        Dropbox. Please retry this request.

        other: None
    FileAction:
      type: object
      properties:
        .tag:
          title: Choice of FileAction
          type: string
          enum:
            - disable_viewer_info
            - edit_contents
            - enable_viewer_info
            - invite_viewer
            - invite_viewer_no_comment
            - unshare
            - relinquish_membership
            - share_link
            - create_link
            - other
      description: >
        Sharing actions that may be taken on files.

        disable_viewer_info: Disable viewer information on the file.

        edit_contents: Change or edit contents of the file.

        enable_viewer_info: Enable viewer information on the file.

        invite_viewer: Add a member with view permissions.

        invite_viewer_no_comment: Add a member with view permissions but no
        comment permissions.

        unshare: Stop sharing this file.

        relinquish_membership: Relinquish one's own membership to the file.

        share_link: Use create_link instead.

        create_link: Create a shared link to the file.

        other: None
    PropertiesSearchMatch:
      type: object
      properties:
        path:
          type: string
          description: The path for the matched file or folder.
        is_deleted:
          type: boolean
          description: Whether the file or folder is deleted.
        id:
          type: string
          description: The ID for the matched file or folder.
        property_groups:
          type: array
          description: List of custom property groups associated with the file.
          items:
            $ref: '#/components/schemas/PropertyGroup'
      description: >
        id: The ID for the matched file or folder.

        path: The path for the matched file or folder.

        is_deleted: Whether the file or folder is deleted.

        property_groups: List of custom property groups associated with the
        file.
    MemberPolicy:
      type: object
      properties:
        .tag:
          title: Choice of MemberPolicy
          type: string
          enum:
            - team
            - anyone
            - other
      description: >
        Policy governing who can be a member of a shared folder. Only applicable
        to folders owned by a user on a team.

        team: Only a teammate can become a member.

        anyone: Anyone can become a member.

        other: None
    UploadWriteFailed:
      type: object
      properties:
        reason:
          $ref: '#/components/schemas/WriteError'
        upload_session_id:
          type: string
          description: >-
            The upload session ID; data has already been uploaded to the
            corresponding upload session and this ID may be used to retry the
            commit with :route:`upload_session/finish`.
      description: >
        reason: The reason why the file couldn't be saved.

        upload_session_id: The upload session ID; data has already been uploaded
        to the corresponding upload session and this ID may be used to retry the
        commit with :route:`upload_session/finish`.
    LaunchEmptyResult:
      type: object
      properties:
        .tag:
          title: Choice of LaunchEmptyResult
          type: string
          enum:
            - async_job_id
            - complete
        async_job_id:
          type: string
          description: >-
            This response indicates that the processing is asynchronous. The
            string is an id that can be used to obtain the status of the
            asynchronous job.
      description: >
        Result returned by methods that may either launch an asynchronous job or
        complete synchronously. Upon synchronous completion of the job, no
        additional information is returned.

        async_job_id: This response indicates that the processing is
        asynchronous. The string is an id that can be used to obtain the status
        of the asynchronous job.

        complete: The job finished synchronously and successfully.
    OfficeAddInPolicy:
      type: object
      properties:
        .tag:
          title: Choice of OfficeAddInPolicy
          type: string
          enum:
            - disabled
            - enabled
            - other
      description: |
        disabled: Office Add-In is disabled.
        enabled: Office Add-In is enabled.
        other: None
    PaperDocUpdateError:
      type: object
      properties:
        .tag:
          title: Choice of PaperDocUpdateError
          type: string
          enum:
            - insufficient_permissions
            - other
            - doc_not_found
            - content_malformed
            - revision_mismatch
            - doc_length_exceeded
            - image_size_exceeded
            - doc_archived
            - doc_deleted
      description: >
        insufficient_permissions: Your account does not have permissions to
        perform this action.

        other: None

        doc_not_found: The required doc was not found.

        content_malformed: The provided content was malformed and cannot be
        imported to Paper.

        revision_mismatch: The provided revision does not match the document
        head.

        doc_length_exceeded: The newly created Paper doc would be too large,
        split the content into multiple docs.

        image_size_exceeded: The imported document contains an image that is too
        large. The current limit is 1MB. Note: This only applies to HTML with
        data uri.

        doc_archived: This operation is not allowed on archived Paper docs.

        doc_deleted: This operation is not allowed on deleted Paper docs.
    UploadSessionFinishError:
      type: object
      properties:
        properties_error:
          $ref: '#/components/schemas/InvalidPropertyGroupError'
        path:
          $ref: '#/components/schemas/WriteError'
        .tag:
          title: Choice of UploadSessionFinishError
          type: string
          enum:
            - lookup_failed
            - path
            - properties_error
            - too_many_shared_folder_targets
            - too_many_write_operations
            - other
        lookup_failed:
          $ref: '#/components/schemas/UploadSessionLookupError'
      description: >
        lookup_failed: The session arguments are incorrect; the value explains
        the reason.

        path: Unable to save the uploaded contents to a file. Data has already
        been appended to the upload session. Please retry with empty data body
        and updated offset.

        properties_error: The supplied property group is invalid. The file has
        uploaded without property groups.

        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.

        too_many_write_operations: There are too many write operations happening
        in the user's Dropbox. You should retry uploading this file.

        other: None
    RemoveTemplateArg:
      type: object
      properties:
        template_id:
          type: string
          description: >-
            An identifier for a template created by
            :route:`templates/add_for_user` or :route:`templates/add_for_team`.
      description: >
        template_id: An identifier for a template created by
        :route:`templates/add_for_user` or :route:`templates/add_for_team`.
    ResolvedVisibility:
      type: object
      properties:
        .tag:
          title: Choice of ResolvedVisibility
          type: string
          enum:
            - public
            - team_only
            - password
            - team_and_password
            - shared_folder_only
            - other
      description: >
        The actual access permissions values of shared links after taking into
        account user preferences and the team and shared folder settings. Check
        the :type:`RequestedVisibility` for more info on the possible visibility
        values that can be set by the shared link's owner.

        public: Anyone who has received the link can access it. No login
        required.

        team_only: Only members of the same team can access the link. Login is
        required.

        password: A link-specific password is required to access the link. Login
        is not required.

        team_and_password: Only members of the same team who have the
        link-specific password can access the link. Login is required.

        shared_folder_only: Only members of the shared folder containing the
        linked file can access the link. Login is required.

        other: None
    PaperDocCreateUpdateResult:
      type: object
      properties:
        title:
          type: string
          description: The Paper doc title.
        doc_id:
          type: string
          description: Doc ID of the newly created doc.
        revision:
          type: number
          description: The Paper doc revision. Simply an ever increasing number.
      description: |
        doc_id: Doc ID of the newly created doc.
        revision: The Paper doc revision. Simply an ever increasing number.
        title: The Paper doc title.
    FolderMetadata:
      type: object
      properties:
        parent_shared_folder_id:
          type: string
          description: >-
            Please use :field:`FileSharingInfo.parent_shared_folder_id` or
            :field:`FolderSharingInfo.parent_shared_folder_id` instead.
        name:
          type: string
          description: >-
            The last component of the path (including extension). This never
            contains a slash.
        path_display:
          type: string
          description: >-
            The cased path to be used for display purposes only. In rare
            instances the casing will not correctly match the user's filesystem,
            but this behavior will match the path provided in the Core API v1,
            and at least the last path component will have the correct casing.
            Changes to only the casing of paths won't be returned by
            :route:`list_folder/continue`. This field will be null if the file
            or folder is not mounted.
        shared_folder_id:
          type: string
          description: Please use :field:`sharing_info` instead.
        path_lower:
          type: string
          description: >-
            The lowercased full path in the user's Dropbox. This always starts
            with a slash. This field will be null if the file or folder is not
            mounted.
        sharing_info:
          $ref: '#/components/schemas/FolderSharingInfo'
        property_groups:
          type: array
          description: >-
            Additional information if the file has custom properties with the
            property template specified. Note that only properties associated
            with user-owned templates, not team-owned templates, can be attached
            to folders.
          items:
            $ref: '#/components/schemas/PropertyGroup'
        id:
          type: string
          description: A unique identifier for the folder.
      description: >
        name: The last component of the path (including extension). This never
        contains a slash.

        id: A unique identifier for the folder.

        path_lower: The lowercased full path in the user's Dropbox. This always
        starts with a slash. This field will be null if the file or folder is
        not mounted.

        path_display: The cased path to be used for display purposes only. In
        rare instances the casing will not correctly match the user's
        filesystem, but this behavior will match the path provided in the Core
        API v1, and at least the last path component will have the correct
        casing. Changes to only the casing of paths won't be returned by
        :route:`list_folder/continue`. This field will be null if the file or
        folder is not mounted.

        parent_shared_folder_id: Please use
        :field:`FileSharingInfo.parent_shared_folder_id` or
        :field:`FolderSharingInfo.parent_shared_folder_id` instead.

        shared_folder_id: Please use :field:`sharing_info` instead.

        sharing_info: Set if the folder is contained in a shared folder or is a
        shared folder mount point.

        property_groups: Additional information if the file has custom
        properties with the property template specified. Note that only
        properties associated with user-owned templates, not team-owned
        templates, can be attached to folders.
    UploadSessionOffsetError:
      type: object
      properties:
        correct_offset:
          type: number
          description: The offset up to which data has been collected.
      description: |
        correct_offset: The offset up to which data has been collected.
    LinkMetadata:
      type: object
      properties:
        url:
          type: string
          description: URL of the shared link.
        expires:
          type: string
          description: Expiration time, if set. By default the link won't expire.
        visibility:
          $ref: '#/components/schemas/Visibility'
      description: >
        Metadata for a shared link. This can be either a
        :type:`PathLinkMetadata` or :type:`CollectionLinkMetadata`.

        url: URL of the shared link.

        visibility: Who can access the link.

        expires: Expiration time, if set. By default the link won't expire.
    SharedFolderMetadata:
      type: object
      properties:
        owner_team:
          $ref: '#/components/schemas/Team'
        parent_shared_folder_id:
          type: string
          description: >-
            The ID of the parent shared folder. This field is present only if
            the folder is contained within another shared folder.
        link_metadata:
          $ref: '#/components/schemas/SharedContentLinkMetadata'
        time_invited:
          type: string
          description: >-
            Timestamp indicating when the current user was invited to this
            shared folder.
        preview_url:
          type: string
          description: URL for displaying a web preview of the shared folder.
        access_type:
          $ref: '#/components/schemas/AccessLevel'
        name:
          type: string
          description: The name of the this shared folder.
        owner_display_names:
          type: array
          description: >-
            The display names of the users that own the folder. If the folder is
            part of a team folder, the display names of the team admins are also
            included. Absent if the owner display names cannot be fetched.
          items:
            type: string
        access_inheritance:
          $ref: '#/components/schemas/AccessInheritance'
        shared_folder_id:
          type: string
          description: The ID of the shared folder.
        path_lower:
          type: string
          description: >-
            The lower-cased full path of this shared folder. Absent for
            unmounted folders.
        policy:
          $ref: '#/components/schemas/FolderPolicy'
        is_inside_team_folder:
          type: boolean
          description: Whether this folder is inside of a team folder.
        is_team_folder:
          type: boolean
          description: >-
            Whether this folder is a :link:`team folder
            https://www.dropbox.com/en/help/986`.
        permissions:
          type: array
          description: >-
            Actions the current user may perform on the folder and its contents.
            The set of permissions corresponds to the FolderActions in the
            request.
          items:
            $ref: '#/components/schemas/FolderPermission'
      description: >
        The metadata which includes basic information about the shared folder.

        access_type: The current user's access level for this shared folder.

        is_inside_team_folder: Whether this folder is inside of a team folder.

        is_team_folder: Whether this folder is a :link:`team folder
        https://www.dropbox.com/en/help/986`.

        name: The name of the this shared folder.

        policy: Policies governing this shared folder.

        preview_url: URL for displaying a web preview of the shared folder.

        shared_folder_id: The ID of the shared folder.

        time_invited: Timestamp indicating when the current user was invited to
        this shared folder.

        owner_display_names: The display names of the users that own the folder.
        If the folder is part of a team folder, the display names of the team
        admins are also included. Absent if the owner display names cannot be
        fetched.

        owner_team: The team that owns the folder. This field is not present if
        the folder is not owned by a team.

        parent_shared_folder_id: The ID of the parent shared folder. This field
        is present only if the folder is contained within another shared folder.

        path_lower: The lower-cased full path of this shared folder. Absent for
        unmounted folders.

        link_metadata: The metadata of the shared content link to this shared
        folder. Absent if there is no link on the folder. This is for an
        unreleased feature so it may not be returned yet.

        permissions: Actions the current user may perform on the folder and its
        contents. The set of permissions corresponds to the FolderActions in the
        request.

        access_inheritance: Whether the folder inherits its members from its
        parent.
    ListSharedLinksResult:
      type: object
      properties:
        has_more:
          type: boolean
          description: >-
            Is true if there are additional shared links that have not been
            returned yet. Pass the cursor into :route:`list_shared_links` to
            retrieve them.
        cursor:
          type: string
          description: >-
            Pass the cursor into :route:`list_shared_links` to obtain the
            additional links. Cursor is returned only if no path is given.
        links:
          type: array
          description: Shared links applicable to the path argument.
          items:
            $ref: '#/components/schemas/SharedLinkMetadata'
      description: >
        links: Shared links applicable to the path argument.

        has_more: Is true if there are additional shared links that have not
        been returned yet. Pass the cursor into :route:`list_shared_links` to
        retrieve them.

        cursor: Pass the cursor into :route:`list_shared_links` to obtain the
        additional links. Cursor is returned only if no path is given.
    UpdateFileRequestError:
      type: object
      properties:
        .tag:
          title: Choice of UpdateFileRequestError
          type: string
          enum:
            - disabled_for_team
            - other
            - not_found
            - not_a_folder
            - app_lacks_access
            - no_permission
            - email_unverified
            - validation_error
      description: >
        There is an error updating the file request.

        disabled_for_team: This user's Dropbox Business team doesn't allow file
        requests.

        other: None

        not_found: This file request ID was not found.

        not_a_folder: The specified path is not a folder.

        app_lacks_access: This file request is not accessible to this app. Apps
        with the app folder permission can only access file requests in their
        app folder.

        no_permission: This user doesn't have permission to access or modify
        this file request.

        email_unverified: This user's email address is not verified. File
        requests are only available on accounts with a verified email address.
        Users can verify their email address :link:`here
        https://www.dropbox.com/help/317`.

        validation_error: There was an error validating the request. For
        example, the title was invalid, or there were disallowed characters in
        the destination path.
    CreateFolderResult:
      type: object
      properties:
        metadata:
          $ref: '#/components/schemas/FolderMetadata'
      description: |
        metadata: Metadata of the created folder.
    RelocationBatchResultData:
      type: object
      properties:
        metadata:
          $ref: '#/components/schemas/Metadata'
      description: |
        metadata: Metadata of the relocated object.
    Visibility:
      type: object
      properties:
        .tag:
          title: Choice of Visibility
          type: string
          enum:
            - public
            - team_only
            - password
            - team_and_password
            - shared_folder_only
            - other
      description: >
        Who can access a shared link. The most open visibility is
        :field:`public`. The default depends on many aspects, such as team and
        user preferences and shared folder settings.

        public: Anyone who has received the link can access it. No login
        required.

        team_only: Only members of the same team can access the link. Login is
        required.

        password: A link-specific password is required to access the link. Login
        is not required.

        team_and_password: Only members of the same team who have the
        link-specific password can access the link.

        shared_folder_only: Only members of the shared folder containing the
        linked file can access the link. Login is required.

        other: None
    DownloadArg:
      type: object
      properties:
        path:
          type: string
          description: The path of the file to download.
        rev:
          type: string
          description: Please specify revision in :field:`path` instead.
      description: |
        path: The path of the file to download.
        rev: Please specify revision in :field:`path` instead.
    SharePathError:
      type: object
      properties:
        .tag:
          title: Choice of SharePathError
          type: string
          enum:
            - is_file
            - inside_shared_folder
            - contains_shared_folder
            - contains_app_folder
            - contains_team_folder
            - is_app_folder
            - inside_app_folder
            - is_public_folder
            - inside_public_folder
            - already_shared
            - invalid_path
            - is_osx_package
            - inside_osx_package
            - other
        already_shared:
          $ref: '#/components/schemas/SharedFolderMetadata'
      description: >
        is_file: A file is at the specified path.

        inside_shared_folder: We do not support sharing a folder inside a shared
        folder.

        contains_shared_folder: We do not support shared folders that contain
        shared folders.

        contains_app_folder: We do not support shared folders that contain app
        folders.

        contains_team_folder: We do not support shared folders that contain team
        folders.

        is_app_folder: We do not support sharing an app folder.

        inside_app_folder: We do not support sharing a folder inside an app
        folder.

        is_public_folder: A public folder can't be shared this way. Use a public
        link instead.

        inside_public_folder: A folder inside a public folder can't be shared
        this way. Use a public link instead.

        already_shared: Folder is already shared. Contains metadata about the
        existing shared folder.

        invalid_path: Path is not valid.

        is_osx_package: We do not support sharing a Mac OS X package.

        inside_osx_package: We do not support sharing a folder inside a Mac OS X
        package.

        other: None
    DeleteError:
      type: object
      properties:
        path_lookup:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of DeleteError
          type: string
          enum:
            - path_lookup
            - path_write
            - too_many_write_operations
            - too_many_files
            - other
        path_write:
          $ref: '#/components/schemas/WriteError'
      description: >
        path_lookup: None

        path_write: None

        too_many_write_operations: There are too many write operations in user's
        Dropbox. Please retry this request.

        too_many_files: There are too many files in one request. Please retry
        with fewer files.

        other: None
    CreateFileRequestArgs:
      type: object
      properties:
        open:
          type: boolean
          description: >-
            Whether or not the file request should be open. If the file request
            is closed, it will not accept any file submissions, but it can be
            opened later.
        destination:
          type: string
          description: >-
            The path of the folder in the Dropbox where uploaded files will be
            sent. For apps with the app folder permission, this will be relative
            to the app folder.
        deadline:
          $ref: '#/components/schemas/FileRequestDeadline'
        title:
          type: string
          description: The title of the file request. Must not be empty.
      description: >
        Arguments for :route:`create`.

        title: The title of the file request. Must not be empty.

        destination: The path of the folder in the Dropbox where uploaded files
        will be sent. For apps with the app folder permission, this will be
        relative to the app folder.

        deadline: The deadline for the file request. Deadlines can only be set
        by Pro and Business accounts.

        open: Whether or not the file request should be open. If the file
        request is closed, it will not accept any file submissions, but it can
        be opened later.
    ChangeFileMemberAccessArgs:
      type: object
      properties:
        member:
          $ref: '#/components/schemas/MemberSelector'
        access_level:
          $ref: '#/components/schemas/AccessLevel'
        file:
          type: string
          description: File for which we are changing a member's access.
      description: |
        Arguments for :route:`change_file_member_access`.
        file: File for which we are changing a member's access.
        member: The member whose access we are changing.
        access_level: The new access level for the member.
    ListFolderContinueError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of ListFolderContinueError
          type: string
          enum:
            - path
            - reset
            - other
      description: >
        path: None

        reset: Indicates that the cursor has been invalidated. Call
        :route:`list_folder` to obtain a new cursor.

        other: None
    UnshareFolderArg:
      type: object
      properties:
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
        leave_a_copy:
          type: boolean
          description: >-
            If true, members of this shared folder will get a copy of this
            folder after it's unshared. Otherwise, it will be removed from their
            Dropbox. The current user, who is an owner, will always retain their
            copy.
      description: >
        shared_folder_id: The ID for the shared folder.

        leave_a_copy: If true, members of this shared folder will get a copy of
        this folder after it's unshared. Otherwise, it will be removed from
        their Dropbox. The current user, who is an owner, will always retain
        their copy.
    TemplateFilterBase:
      type: object
      properties:
        filter_some:
          type: array
          description: >-
            Only templates with an ID in the supplied list will be returned (a
            subset of templates will be returned).
          items:
            type: string
        .tag:
          title: Choice of TemplateFilterBase
          type: string
          enum:
            - filter_some
            - other
      description: >
        filter_some: Only templates with an ID in the supplied list will be
        returned (a subset of templates will be returned).

        other: None
    UserOnPaperDocFilter:
      type: object
      properties:
        .tag:
          title: Choice of UserOnPaperDocFilter
          type: string
          enum:
            - visited
            - shared
            - other
      description: >
        visited: all users who have visited the Paper doc.

        shared: All uses who are shared on the Paper doc. This includes all
        users who have visited the Paper doc as well as those who have not.

        other: None
    UploadSessionFinishArg:
      type: object
      properties:
        cursor:
          $ref: '#/components/schemas/UploadSessionCursor'
        commit:
          $ref: '#/components/schemas/CommitInfo'
      description: |
        cursor: Contains the upload session ID and the offset.
        commit: Contains the path and other optional modifiers for the commit.
    FullAccount:
      type: object
      properties:
        referral_link:
          type: string
          description: The user's :link:`referral link https://www.dropbox.com/referrals`.
        account_type:
          $ref: '#/components/schemas/AccountType'
        account_id:
          type: string
          description: The user's unique Dropbox ID.
        locale:
          type: string
          description: >-
            The language that the user specified. Locale tags will be
            :link:`IETF language tags
            http://en.wikipedia.org/wiki/IETF_language_tag`.
        email_verified:
          type: boolean
          description: Whether the user has verified their e-mail address.
        team_member_id:
          type: string
          description: >-
            This account's unique team member id. This field will only be
            present if :field:`team` is present.
        root_info:
          $ref: '#/components/schemas/RootInfo'
        disabled:
          type: boolean
          description: Whether the user has been disabled.
        is_paired:
          type: boolean
          description: >-
            Whether the user has a personal and work account. If the current
            account is personal, then :field:`team` will always be :val:`null`,
            but :field:`is_paired` will indicate if a work account is linked.
        team:
          $ref: '#/components/schemas/FullTeam'
        country:
          type: string
          description: >-
            The user's two-letter country code, if available. Country codes are
            based on :link:`ISO 3166-1 http://en.wikipedia.org/wiki/ISO_3166-1`.
        email:
          type: string
          description: >-
            The user's e-mail address. Do not rely on this without checking the
            :field:`email_verified` field. Even then, it's possible that the
            user has since lost access to their e-mail.
        profile_photo_url:
          type: string
          description: URL for the photo representing the user, if one is set.
        name:
          $ref: '#/components/schemas/Name'
      description: >
        Detailed information about the current user's account.

        account_id: The user's unique Dropbox ID.

        name: Details of a user's name.

        email: The user's e-mail address. Do not rely on this without checking
        the :field:`email_verified` field. Even then, it's possible that the
        user has since lost access to their e-mail.

        email_verified: Whether the user has verified their e-mail address.

        disabled: Whether the user has been disabled.

        locale: The language that the user specified. Locale tags will be
        :link:`IETF language tags
        http://en.wikipedia.org/wiki/IETF_language_tag`.

        referral_link: The user's :link:`referral link
        https://www.dropbox.com/referrals`.

        is_paired: Whether the user has a personal and work account. If the
        current account is personal, then :field:`team` will always be
        :val:`null`, but :field:`is_paired` will indicate if a work account is
        linked.

        account_type: What type of account this user has.

        root_info: The root info for this account.

        profile_photo_url: URL for the photo representing the user, if one is
        set.

        country: The user's two-letter country code, if available. Country codes
        are based on :link:`ISO 3166-1 http://en.wikipedia.org/wiki/ISO_3166-1`.

        team: If this account is a member of a team, information about that
        team.

        team_member_id: This account's unique team member id. This field will
        only be present if :field:`team` is present.
    CreateSharedLinkError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of CreateSharedLinkError
          type: string
          enum:
            - path
            - other
      description: |
        path: None
        other: None
    PathLinkMetadata:
      type: object
      properties:
        url:
          type: string
          description: URL of the shared link.
        path:
          type: string
          description: Path in user's Dropbox.
        expires:
          type: string
          description: Expiration time, if set. By default the link won't expire.
        visibility:
          $ref: '#/components/schemas/Visibility'
      description: |
        Metadata for a path-based shared link.
        url: URL of the shared link.
        visibility: Who can access the link.
        path: Path in user's Dropbox.
        expires: Expiration time, if set. By default the link won't expire.
    TransferFolderArg:
      type: object
      properties:
        shared_folder_id:
          type: string
          description: The ID for the shared folder.
        to_dropbox_id:
          type: string
          description: A account or team member ID to transfer ownership to.
      description: |
        shared_folder_id: The ID for the shared folder.
        to_dropbox_id: A account or team member ID to transfer ownership to.
    AlphaGetMetadataError:
      type: object
      properties:
        properties_error:
          $ref: '#/components/schemas/LookUpPropertiesError'
        path:
          $ref: '#/components/schemas/LookupError'
        .tag:
          title: Choice of AlphaGetMetadataError
          type: string
          enum:
            - path
            - properties_error
      description: |
        path: None
        properties_error: None
    RemoveFolderMemberError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of RemoveFolderMemberError
          type: string
          enum:
            - access_error
            - member_error
            - folder_owner
            - group_access
            - team_folder
            - no_permission
            - too_many_files
            - other
        member_error:
          $ref: '#/components/schemas/SharedFolderMemberError'
      description: >
        access_error: None

        member_error: None

        folder_owner: The target user is the owner of the shared folder. You
        can't remove this user until ownership has been transferred to another
        member.

        group_access: The target user has access to the shared folder via a
        group.

        team_folder: This action cannot be performed on a team shared folder.

        no_permission: The current user does not have permission to perform this
        action.

        too_many_files: This shared folder has too many files for leaving a
        copy. You can still remove this user without leaving a copy.

        other: None
    GetFileRequestError:
      type: object
      properties:
        .tag:
          title: Choice of GetFileRequestError
          type: string
          enum:
            - disabled_for_team
            - other
            - not_found
            - not_a_folder
            - app_lacks_access
            - no_permission
            - email_unverified
            - validation_error
      description: >
        There was an error retrieving the specified file request.

        disabled_for_team: This user's Dropbox Business team doesn't allow file
        requests.

        other: None

        not_found: This file request ID was not found.

        not_a_folder: The specified path is not a folder.

        app_lacks_access: This file request is not accessible to this app. Apps
        with the app folder permission can only access file requests in their
        app folder.

        no_permission: This user doesn't have permission to access or modify
        this file request.

        email_unverified: This user's email address is not verified. File
        requests are only available on accounts with a verified email address.
        Users can verify their email address :link:`here
        https://www.dropbox.com/help/317`.

        validation_error: There was an error validating the request. For
        example, the title was invalid, or there were disallowed characters in
        the destination path.
    FileRequestDeadline:
      type: object
      properties:
        deadline:
          type: string
          description: The deadline for this file request.
        allow_late_uploads:
          $ref: '#/components/schemas/GracePeriod'
      description: >
        deadline: The deadline for this file request.

        allow_late_uploads: If set, allow uploads after the deadline has passed.
        These     uploads will be marked overdue.
    InsufficientPlan:
      type: object
      properties:
        message:
          type: string
          description: >-
            A message to tell the user to upgrade in order to support expected
            action.
        upsell_url:
          type: string
          description: >-
            A URL to send the user to in order to obtain the account type they
            need, e.g. upgrading. Absent if there is no action the user can take
            to upgrade.
      description: >
        message: A message to tell the user to upgrade in order to support
        expected action.

        upsell_url: A URL to send the user to in order to obtain the account
        type they need, e.g. upgrading. Absent if there is no action the user
        can take to upgrade.
    PaperDocUpdatePolicy:
      type: object
      properties:
        .tag:
          title: Choice of PaperDocUpdatePolicy
          type: string
          enum:
            - append
            - prepend
            - overwrite_all
            - other
      description: >
        append: The content will be appended to the doc.

        prepend: The content will be prepended to the doc.

        Note: the doc title will not be affected.

        overwrite_all: The document will be overwitten at the head with the
        provided content.

        other: None
    UploadSessionFinishBatchArg:
      type: object
      properties:
        entries:
          type: array
          description: Commit information for each file in the batch.
          items:
            $ref: '#/components/schemas/UploadSessionFinishArg'
      description: |
        entries: Commit information for each file in the batch.
    Dimensions:
      type: object
      properties:
        width:
          type: number
          description: Width of the photo/video.
        height:
          type: number
          description: Height of the photo/video.
      description: |
        Dimensions for a photo or video.
        height: Height of the photo/video.
        width: Width of the photo/video.
    PropertiesSearchError:
      type: object
      properties:
        .tag:
          title: Choice of PropertiesSearchError
          type: string
          enum:
            - property_group_lookup
            - other
        property_group_lookup:
          $ref: '#/components/schemas/LookUpPropertiesError'
      description: |
        property_group_lookup: None
        other: None
    GetFileMetadataError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of GetFileMetadataError
          type: string
          enum:
            - user_error
            - access_error
            - other
        user_error:
          $ref: '#/components/schemas/SharingUserError'
      description: |
        Error result for :route:`get_file_metadata`.
        user_error: None
        access_error: None
        other: None
    GetTemplateResult:
      type: object
      properties:
        fields:
          type: array
          description: >-
            Definitions of the property fields associated with this template.
            There can be up to 32 properties in a single template.
          items:
            $ref: '#/components/schemas/PropertyFieldTemplate'
        name:
          type: string
          description: >-
            Display name for the template. Template names can be up to 256
            bytes.
        description:
          type: string
          description: >-
            Description for the template. Template descriptions can be up to
            1024 bytes.
      description: >
        name: Display name for the template. Template names can be up to 256
        bytes.

        description: Description for the template. Template descriptions can be
        up to 1024 bytes.

        fields: Definitions of the property fields associated with this
        template. There can be up to 32 properties in a single template.
    LookupError:
      type: object
      properties:
        malformed_path:
          type: string
        .tag:
          title: Choice of LookupError
          type: string
          enum:
            - malformed_path
            - not_found
            - not_file
            - not_folder
            - restricted_content
            - other
      description: >
        malformed_path: None

        not_found: There is nothing at the given path.

        not_file: We were expecting a file, but the given path refers to
        something that isn't a file.

        not_folder: We were expecting a folder, but the given path refers to
        something that isn't a folder.

        restricted_content: The file cannot be transferred because the content
        is restricted.  For example, sometimes there are legal restrictions due
        to copyright claims.

        other: None
    CreateFolderBatchJobStatus:
      type: object
      properties:
        failed:
          $ref: '#/components/schemas/CreateFolderBatchError'
        .tag:
          title: Choice of CreateFolderBatchJobStatus
          type: string
          enum:
            - in_progress
            - complete
            - failed
            - other
        complete:
          $ref: '#/components/schemas/CreateFolderBatchResult'
      description: |
        in_progress: The asynchronous job is still in progress.
        complete: The batch create folder has finished.
        failed: The batch create folder has failed.
        other: None
    ListTemplateResult:
      type: object
      properties:
        template_ids:
          type: array
          description: >-
            List of identifiers for templates added by  See
            :route:`templates/add_for_user` or :route:`templates/add_for_team`.
          items:
            type: string
      description: >
        template_ids: List of identifiers for templates added by  See
        :route:`templates/add_for_user` or :route:`templates/add_for_team`.
    TemplateError:
      type: object
      properties:
        .tag:
          title: Choice of TemplateError
          type: string
          enum:
            - template_not_found
            - restricted_content
            - other
        template_not_found:
          type: string
          description: Template does not exist for the given identifier.
      description: |
        template_not_found: Template does not exist for the given identifier.
        restricted_content: You do not have permission to modify this template.
        other: None
    GetCopyReferenceResult:
      type: object
      properties:
        expires:
          type: string
          description: >-
            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.
        copy_reference:
          type: string
          description: A copy reference to the file or folder.
        metadata:
          $ref: '#/components/schemas/Metadata'
      description: >
        metadata: Metadata of the file or folder.

        copy_reference: A copy reference to the file or folder.

        expires: 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.
    PropertiesSearchMode:
      type: object
      properties:
        .tag:
          title: Choice of PropertiesSearchMode
          type: string
          enum:
            - field_name
            - other
        field_name:
          type: string
          description: Search for a value associated with this field name.
      description: |
        field_name: Search for a value associated with this field name.
        other: None
    RelocationArg:
      type: object
      properties:
        allow_ownership_transfer:
          type: boolean
          description: >-
            Allow moves by owner even if it would result in an ownership
            transfer for the content being moved. This does not apply to copies.
        from_path:
          type: string
          description: Path in the user's Dropbox to be copied or moved.
        to_path:
          type: string
          description: Path in the user's Dropbox that is the destination.
        autorename:
          type: boolean
          description: >-
            If there's a conflict, have the Dropbox server try to autorename the
            file to avoid the conflict.
        allow_shared_folder:
          type: boolean
          description: >-
            If true, :route:`copy` will copy contents in shared folder,
            otherwise :field:`RelocationError.cant_copy_shared_folder` will be
            returned if :field:`from_path` contains shared folder. This field is
            always true for :route:`move`.
      description: >
        from_path: Path in the user's Dropbox to be copied or moved.

        to_path: Path in the user's Dropbox that is the destination.

        allow_shared_folder: If true, :route:`copy` will copy contents in shared
        folder, otherwise :field:`RelocationError.cant_copy_shared_folder` will
        be returned if :field:`from_path` contains shared folder. This field is
        always true for :route:`move`.

        autorename: If there's a conflict, have the Dropbox server try to
        autorename the file to avoid the conflict.

        allow_ownership_transfer: Allow moves by owner even if it would result
        in an ownership transfer for the content being moved. This does not
        apply to copies.
    AlphaGetMetadataArg:
      type: object
      properties:
        include_property_groups:
          $ref: '#/components/schemas/TemplateFilterBase'
        include_property_templates:
          type: array
          description: >-
            If set to a valid list of template IDs,
            :field:`FileMetadata.property_groups` is set for files with custom
            properties.
          items:
            type: string
        include_has_explicit_shared_members:
          type: boolean
          description: >-
            If true, the results will include a flag for each file indicating
            whether or not  that file has any explicit members.
        include_deleted:
          type: boolean
          description: >-
            If true, :type:`DeletedMetadata` will be returned for deleted file
            or folder, otherwise :field:`LookupError.not_found` will be
            returned.
        include_media_info:
          type: boolean
          description: >-
            If true, :field:`FileMetadata.media_info` is set for photo and
            video.
        path:
          type: string
          description: The path of a file or folder on Dropbox.
      description: >
        path: The path of a file or folder on Dropbox.

        include_media_info: If true, :field:`FileMetadata.media_info` is set for
        photo and video.

        include_deleted: 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: If true, the results will include a
        flag for each file indicating whether or not  that file has any explicit
        members.

        include_property_groups: If set to a valid list of template IDs,
        :field:`FileMetadata.property_groups` is set if there exists property
        data associated with the file and each of the listed templates.

        include_property_templates: If set to a valid list of template IDs,
        :field:`FileMetadata.property_groups` is set for files with custom
        properties.
    ListUsersCursorError:
      type: object
      properties:
        cursor_error:
          $ref: '#/components/schemas/PaperApiCursorError'
        .tag:
          title: Choice of ListUsersCursorError
          type: string
          enum:
            - insufficient_permissions
            - other
            - doc_not_found
            - cursor_error
      description: >
        insufficient_permissions: Your account does not have permissions to
        perform this action.

        other: None

        doc_not_found: The required doc was not found.

        cursor_error: None
    UploadSessionCursor:
      type: object
      properties:
        session_id:
          type: string
          description: The upload session ID (returned by :route:`upload_session/start`).
        offset:
          type: number
          description: >-
            The amount of data that has been uploaded so far. We use this to
            make sure upload data isn't lost or duplicated in the event of a
            network error.
      description: >
        session_id: The upload session ID (returned by
        :route:`upload_session/start`).

        offset: The amount of data that has been uploaded so far. We use this to
        make sure upload data isn't lost or duplicated in the event of a network
        error.
    ListFolderMembersContinueError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharedFolderAccessError'
        .tag:
          title: Choice of ListFolderMembersContinueError
          type: string
          enum:
            - access_error
            - invalid_cursor
            - other
      description: |
        access_error: None
        invalid_cursor: :field:`ListFolderMembersContinueArg.cursor` is invalid.
        other: None
    RestoreArg:
      type: object
      properties:
        path:
          type: string
          description: The path to the file you want to restore.
        rev:
          type: string
          description: The revision to restore for the file.
      description: |
        path: The path to the file you want to restore.
        rev: The revision to restore for the file.
    MediaMetadata:
      type: object
      properties:
        dimensions:
          $ref: '#/components/schemas/Dimensions'
        location:
          $ref: '#/components/schemas/GpsCoordinates'
        time_taken:
          type: string
          description: The timestamp when the photo/video is taken.
      description: |
        Metadata for a photo or video.
        dimensions: Dimension of the photo/video.
        location: The GPS coordinate of the photo/video.
        time_taken: The timestamp when the photo/video is taken.
    DeleteBatchJobStatus:
      type: object
      properties:
        failed:
          $ref: '#/components/schemas/DeleteBatchError'
        .tag:
          title: Choice of DeleteBatchJobStatus
          type: string
          enum:
            - in_progress
            - complete
            - failed
            - other
        complete:
          $ref: '#/components/schemas/DeleteBatchResult'
      description: |
        in_progress: The asynchronous job is still in progress.
        complete: The batch delete has finished.
        failed: The batch delete has failed.
        other: None
    RemoveFileMemberError:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of RemoveFileMemberError
          type: string
          enum:
            - user_error
            - access_error
            - no_explicit_access
            - other
        user_error:
          $ref: '#/components/schemas/SharingUserError'
        no_explicit_access:
          $ref: '#/components/schemas/MemberAccessLevelResult'
      description: >
        Errors for :route:`remove_file_member_2`.

        user_error: None

        access_error: None

        no_explicit_access: This member does not have explicit access to the
        file and therefore cannot be removed. The return value is the access
        that a user might have to the file from a parent folder.

        other: None
    CreateFolderError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/WriteError'
        .tag:
          title: Choice of CreateFolderError
          type: string
          enum:
            - path
      description: |
        path: None
    ListRevisionsMode:
      type: object
      properties:
        .tag:
          title: Choice of ListRevisionsMode
          type: string
          enum:
            - path
            - id
            - other
      description: >
        path: Returns revisions with the same file path as identified by the
        latest file entry at the given file path or id.

        id: Returns revisions with the same file id as identified by the latest
        file entry at the given file path or id.

        other: None
    DeleteBatchLaunch:
      type: object
      properties:
        .tag:
          title: Choice of DeleteBatchLaunch
          type: string
          enum:
            - async_job_id
            - complete
            - other
        async_job_id:
          type: string
          description: >-
            This response indicates that the processing is asynchronous. The
            string is an id that can be used to obtain the status of the
            asynchronous job.
        complete:
          $ref: '#/components/schemas/DeleteBatchResult'
      description: >
        Result returned by :route:`delete_batch` that may either launch an
        asynchronous job or complete synchronously.

        async_job_id: This response indicates that the processing is
        asynchronous. The string is an id that can be used to obtain the status
        of the asynchronous job.

        complete: None

        other: None
    TokenFromOAuth1Arg:
      type: object
      properties:
        oauth1_token:
          type: string
          description: The supplied OAuth 1.0 access token.
        oauth1_token_secret:
          type: string
          description: The token secret associated with the supplied access token.
      description: >
        oauth1_token: The supplied OAuth 1.0 access token.

        oauth1_token_secret: The token secret associated with the supplied
        access token.
    ListUsersOnPaperDocResponse:
      type: object
      properties:
        cursor:
          $ref: '#/components/schemas/Cursor'
        has_more:
          type: boolean
          description: >-
            Will be set to True if a subsequent call with the provided cursor to
            :route:`docs/users/list/continue` returns immediately with some
            results. If set to False please allow some delay before making
            another call to :route:`docs/users/list/continue`.
        doc_owner:
          $ref: '#/components/schemas/UserInfo'
        users:
          type: array
          description: >-
            List of users with their respective permission levels that are
            invited on the Paper folder.
          items:
            $ref: '#/components/schemas/UserInfoWithPermissionLevel'
        invitees:
          type: array
          description: >-
            List of email addresses with their respective permission levels that
            are invited on the Paper doc.
          items:
            $ref: '#/components/schemas/InviteeInfoWithPermissionLevel'
      description: >
        invitees: List of email addresses with their respective permission
        levels that are invited on the Paper doc.

        users: List of users with their respective permission levels that are
        invited on the Paper folder.

        doc_owner: The Paper doc owner. This field is populated on every single
        response.

        cursor: Pass the cursor into :route:`docs/users/list/continue` to
        paginate through all users. The cursor preserves all properties as
        specified in the original call to :route:`docs/users/list`.

        has_more: Will be set to True if a subsequent call with the provided
        cursor to :route:`docs/users/list/continue` returns immediately with
        some results. If set to False please allow some delay before making
        another call to :route:`docs/users/list/continue`.
    GetThumbnailBatchError:
      type: object
      properties:
        .tag:
          title: Choice of GetThumbnailBatchError
          type: string
          enum:
            - too_many_files
            - other
      description: |
        too_many_files: The operation involves more than 25 files.
        other: None
    ListFileMembersIndividualResult:
      type: object
      properties:
        access_error:
          $ref: '#/components/schemas/SharingFileAccessError'
        .tag:
          title: Choice of ListFileMembersIndividualResult
          type: string
          enum:
            - result
            - access_error
            - other
        result:
          $ref: '#/components/schemas/ListFileMembersCountResult'
      description: |
        result: The results of the query for this file if it was successful.
        access_error: The result of the query for this file if it was an error.
        other: None
    PropertyField:
      type: object
      properties:
        name:
          type: string
          description: >-
            Key of the property field associated with a file and template. Keys
            can be up to 256 bytes.
        value:
          type: string
          description: >-
            Value of the property field associated with a file and template.
            Values can be up to 1024 bytes.
      description: >
        Raw key/value data to be associated with a Dropbox file. Property fields
        are added to Dropbox files as a :type:`PropertyGroup`.

        name: Key of the property field associated with a file and template.
        Keys can be up to 256 bytes.

        value: Value of the property field associated with a file and template.
        Values can be up to 1024 bytes.
    PropertiesSearchResult:
      type: object
      properties:
        matches:
          type: array
          description: A list (possibly empty) of matches for the query.
          items:
            $ref: '#/components/schemas/PropertiesSearchMatch'
        cursor:
          type: string
          description: >-
            Pass the cursor into :route:`properties/search/continue` to continue
            to receive search results. Cursor will be null when there are no
            more results.
      description: >
        matches: A list (possibly empty) of matches for the query.

        cursor: Pass the cursor into :route:`properties/search/continue` to
        continue to receive search results. Cursor will be null when there are
        no more results.
    ListPaperDocsFilterBy:
      type: object
      properties:
        .tag:
          title: Choice of ListPaperDocsFilterBy
          type: string
          enum:
            - docs_accessed
            - docs_created
            - other
      description: >
        docs_accessed: Fetches all Paper doc IDs that the user has ever
        accessed.

        docs_created: Fetches only the Paper doc IDs that the user has created.

        other: None
    AccessInheritance:
      type: object
      properties:
        .tag:
          title: Choice of AccessInheritance
          type: string
          enum:
            - inherit
            - no_inherit
            - other
      description: >
        Information about the inheritance policy of a shared folder.

        inherit: The shared folder inherits its members from the parent folder.

        no_inherit: The shared folder does not inherit its members from the
        parent folder.

        other: None
    ListFolderLongpollResult:
      type: object
      properties:
        changes:
          type: boolean
          description: >-
            Indicates whether new changes are available. If true, call
            :route:`list_folder/continue` to retrieve the changes.
        backoff:
          type: number
          description: >-
            If present, backoff for at least this many seconds before calling
            :route:`list_folder/longpoll` again.
      description: >
        changes: Indicates whether new changes are available. If true, call
        :route:`list_folder/continue` to retrieve the changes.

        backoff: If present, backoff for at least this many seconds before
        calling :route:`list_folder/longpoll` again.
    AclUpdatePolicy:
      type: object
      properties:
        .tag:
          title: Choice of AclUpdatePolicy
          type: string
          enum:
            - owner
            - editors
            - other
      description: >
        Who can change a shared folder's access control list (ACL). In other
        words, who can add, remove, or change the privileges of members.

        owner: Only the owner can update the ACL.

        editors: Any editor can update the ACL. This may be further restricted
        to editors on the same team.

        other: None
    ListFileMembersContinueArg:
      type: object
      properties:
        cursor:
          type: string
          description: >-
            The cursor returned by your last call to :route:`list_file_members`,
            :route:`list_file_members/continue`, or
            :route:`list_file_members/batch`.
      description: >
        Arguments for :route:`list_file_members/continue`.

        cursor: The cursor returned by your last call to
        :route:`list_file_members`, :route:`list_file_members/continue`, or
        :route:`list_file_members/batch`.
    ListPaperDocsResponse:
      type: object
      properties:
        cursor:
          $ref: '#/components/schemas/Cursor'
        has_more:
          type: boolean
          description: >-
            Will be set to True if a subsequent call with the provided cursor to
            :route:`docs/list/continue` returns immediately with some results.
            If set to False please allow some delay before making another call
            to :route:`docs/list/continue`.
        doc_ids:
          type: array
          description: >-
            The list of Paper doc IDs that can be used to access the given Paper
            docs or supplied to other API methods. The list is sorted in the
            order specified by the initial call to :route:`docs/list`.
          items:
            type: string
      description: >
        doc_ids: The list of Paper doc IDs that can be used to access the given
        Paper docs or supplied to other API methods. The list is sorted in the
        order specified by the initial call to :route:`docs/list`.

        cursor: Pass the cursor into :route:`docs/list/continue` to paginate
        through all files. The cursor preserves all properties as specified in
        the original call to :route:`docs/list`.

        has_more: Will be set to True if a subsequent call with the provided
        cursor to :route:`docs/list/continue` returns immediately with some
        results. If set to False please allow some delay before making another
        call to :route:`docs/list/continue`.
    RelinquishFileMembershipArg:
      type: object
      properties:
        file:
          type: string
          description: The path or id for the file.
      description: |
        file: The path or id for the file.
    GetSharedLinksResult:
      type: object
      properties:
        links:
          type: array
          description: Shared links applicable to the path argument.
          items:
            $ref: '#/components/schemas/LinkMetadata'
      description: |
        links: Shared links applicable to the path argument.
    CreateFolderEntryError:
      type: object
      properties:
        path:
          $ref: '#/components/schemas/WriteError'
        .tag:
          title: Choice of CreateFolderEntryError
          type: string
          enum:
            - path
            - other
      description: |
        path: None
        other: None
    LinkAction:
      type: object
      properties:
        .tag:
          title: Choice of LinkAction
          type: string
          enum:
            - change_access_level
            - change_audience
            - remove_expiry
            - remove_password
            - set_expiry
            - set_password
            - other
      description: |
        Actions that can be performed on a link.
        change_access_level: Change the access level of the link.
        change_audience: Change the audience of the link.
        remove_expiry: Remove the expiry date of the link.
        remove_password: Remove the password of the link.
        set_expiry: Create or modify the expiry date of the link.
        set_password: Create or modify the password of the link.
        other: None
    LinkExpiry:
      type: object
      properties:
        set_expiry:
          type: string
          description: Set a new expiry or change an existing expiry.
        .tag:
          title: Choice of LinkExpiry
          type: string
          enum:
            - remove_expiry
            - set_expiry
            - other
      description: |
        remove_expiry: Remove the currently set expiry for the link.
        set_expiry: Set a new expiry or change an existing expiry.
        other: None
    PendingUploadMode:
      type: object
      properties:
        .tag:
          title: Choice of PendingUploadMode
          type: string
          enum:
            - file
            - folder
      description: >
        Flag to indicate pending upload default (for linking to not-yet-existing
        paths).

        file: Assume pending uploads are files.

        folder: Assume pending uploads are folders.
    GetSharedLinksError:
      type: object
      properties:
        path:
          type: string
        .tag:
          title: Choice of GetSharedLinksError
          type: string
          enum:
            - path
            - other
      description: |
        path: None
        other: None
    RelocationBatchJobStatus:
      type: object
      properties:
        failed:
          $ref: '#/components/schemas/RelocationBatchError'
        .tag:
          title: Choice of RelocationBatchJobStatus
          type: string
          enum:
            - in_progress
            - complete
            - failed
        complete:
          $ref: '#/components/schemas/RelocationBatchResult'
      description: |
        in_progress: The asynchronous job is still in progress.
        complete: The copy or move batch job has finished.
        failed: The copy or move batch job has failed with exception.