Download File

Download a file from Dropbox for Business using a file path, file ID, or file revision number.

Options

Field Definition Type Required
Search By Indicates the method by which a file is identified for download; options are:
  • File Path

  • File ID

  • File Revision Number

Dropdown TRUE

Input

Field Definition Type Required
Search File By
File Path (when the File Path option is selected) Display path of the location for the uploaded file; for example, /Homework/math/Prime_Numbers.txt. Dropdown TRUE
File ID (when the File ID option is selected) Unique identifier for the uploaded file; for example, id:a4ayc_80_OEAAAAAAAAAXw. Dropdown TRUE
File Revision Number (when the File Revision Number option is selectewd) Unique identifier for the current revision of the uploaded file; for example, rev:a1c10ce0dd78. Dropdown TRUE
Caution

A file must be at least 1 byte in size, but cannot be larger than 2 GB. See Workflows system limits.

The Dropbox for Business API has a limit of 150 MB for file uploads.

Output

Field Definition Type
Metadata Info
Name Name of the uploaded file; for example, Prime_Numbers.txt. String
File ID Unique identifier for the uploaded file; for example, id:a4ayc_80_OEAAAAAAAAAXw. String
Path Display path of the uploaded file; for example, /Homework/math/Prime_Numbers.txt. String
Revision Number Unique identifier for the current revision of the uploaded file; for example, rev:a1c10ce0dd78.

This value is the same revision number as elsewhere in the Dropbox for Business API and can be used to detect changes and avoid conflicts.

String
Client Time Modified Value of the 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. The timestamp is in the format Y-%m-%dT%H:%M:%SZ. Date &Time
Server Time Modified Last time the file was modified on Dropbox. The timestamp is in the format Y-%m-%dT%H:%M:%SZ. Date &Time
Size File size in bytes. String
File Content File contents that you want to upload from the Workflows file system. File
Is Downloadable? If True, indicates that the file can be downloaded directly; else the file must be exported. Boolean
Has Explicit Shared Members? Indicates whether the file has any explicit shared members. Boolean
Content Hash A hash of the file content. This field can be used to verify data integrity. String
Symlink Info
Target Target to which this symlink points. String
Sharing Info
Read Only? If True, indicates that the file or folder is inside a read-only shared folder. Boolean
Parent Shared Folder ID ID of shared folder that holds this file. String
Modified By Last user who modified the file. This field will be null if the user's account has been deleted. String
Export Info
Export As Format to which the file can be exported. String
File Lock Info
Is Lockholder? If True, indicates that the caller holds the file lock. Boolean
Lockholder Name Display name of the lock holder. String
Lockholder Account ID Account ID of the lock holder if known. String
Created Date Time Timestamp of the lock was created. Date & Time

Related topics

Dropbox for Business connector

About the elements of Okta Workflows

Dropbox Developer Documentation