Dropbox Download

Dropbox Download

Certified

Download Dropbox file to storage

Downloads a Dropbox file and writes it to Kestra internal storage. Source path must start with / or be read from a kestra:// URI. Fails if the path is missing or token lacks read access.

yaml
type: io.kestra.plugin.dropbox.files.Download

Download a file from a specific Dropbox path.

yaml
id: dropbox_download_file
namespace: company.team
tasks:
  - id: download_report
    type: io.kestra.plugin.dropbox.files.Download
    accessToken: "{{ secret('DROPBOX_ACCESS_TOKEN') }}"
    from: "/shared_reports/quarterly_report.csv"

Download a file using a path from a previous task's output.

yaml
id: dropbox_download_dynamic_path
namespace: company.team
tasks:
  - id: generate_path_file
    type: io.kestra.plugin.core.storage.Write
    content: "/dynamic/data/{{ execution.startDate }}.json"
    # Kestra automatically generates the output URI
  - id: download_dynamic_file
    type: io.kestra.plugin.dropbox.files.Download
    accessToken: "{{ secret('DROPBOX_ACCESS_TOKEN') }}"
    from: "{{ outputs.generate_path_file.uri }}" # Reference the generated URI
Properties

Dropbox access token

Token must allow reading the source path.

Path to download

Literal Dropbox path or kestra:// URI containing the path. Must start with /.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Downloaded file metadata

Definitions
clientModifiedstring
Formatdate-time
contentHashstring
exportInfo
exportAsstring
exportOptionsarray
SubTypestring
fileLockInfo
createdstring
Formatdate-time
isLockholderboolean
lockholderAccountIdstring
lockholderNamestring
hasExplicitSharedMembersboolean
idstring
isDownloadableboolean
isRestorableboolean
mediaInfo
metadataValue
dimensions
location
timeTakenstring
Formatdate-time
namestring
parentSharedFolderIdstring
pathDisplaystring
pathLowerstring
previewUrlstring
propertyGroupsarray
fieldsarray
namestring
valuestring
templateIdstring
revstring
serverModifiedstring
Formatdate-time
sharingInfo
modifiedBystring
parentSharedFolderIdstring
readOnlyboolean
sizeinteger
symlinkInfo
targetstring
Formaturi

Downloaded file URI