Dropbox Upload
CertifiedUpload file to Dropbox
Dropbox Upload
Upload file to Dropbox
Uploads a file from Kestra internal storage to a Dropbox path. Destination must start with /. Honors mode (default ADD) and optional server-side autorename when conflicts occur.
type: io.kestra.plugin.dropbox.files.UploadExamples
Upload a file from Kestra's internal storage to Dropbox.
id: dropbox_upload_file
namespace: company.team
tasks:
- id: create_file_to_upload
type: io.kestra.plugin.core.storage.Write
content: "This is the content of the file to be uploaded."
- id: upload_to_dropbox
type: io.kestra.plugin.dropbox.files.Upload
accessToken: "{{ secret('DROPBOX_ACCESS_TOKEN') }}"
from: "{{ outputs.create_file_to_upload.uri }}" # URI from previous task
to: "/kestra_uploads/my_file.txt"
mode: "OVERWRITE"
autorename: false
Properties
accessToken *string
Dropbox access token
Token must allow writing to the destination path.
from *object
Source file URI
Kestra storage URI string (e.g., {{ outputs.prev_task.uri }}) or URI object.
to *string
Destination Dropbox path
Must start with /, e.g., /my_folder/file.txt.
assets
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.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset 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.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150autorename booleanstring
falseAuto-rename on conflict
Default false. When true with ADD, Dropbox appends suffixes like (1) if the path exists.
mode string
ADDWrite mode on conflict
ADD (default): keep the existing file; on a conflict the upload is renamed with a suffix only when autorename is true, otherwise it fails.
OVERWRITE: replace existing file.
Outputs
metadata
Uploaded file metadata
com.dropbox.core.v2.files.FileMetadata
date-timecom.dropbox.core.v2.files.ExportInfo
com.dropbox.core.v2.files.FileLockMetadata
date-timecom.dropbox.core.v2.files.MediaInfo
com.dropbox.core.v2.files.MediaMetadata
date-timecom.dropbox.core.v2.fileproperties.PropertyGroup
com.dropbox.core.v2.fileproperties.PropertyField
date-time
