Dropbox List
CertifiedList Dropbox directory entries
Dropbox List
List Dropbox directory entries
Lists files and folders under a path (default root). The path is provided as a string and should start with / when set. Supports recursion, limit (default 2000), and fetchType (default FETCH) to control memory vs storage output.
type: io.kestra.plugin.dropbox.files.ListExamples
List all files and folders in a specific Dropbox directory.
id: dropbox_list_files
namespace: company.team
tasks:
- id: list_files_from_dropbox
type: io.kestra.plugin.dropbox.files.List
accessToken: "{{ secret('DROPBOX_ACCESS_TOKEN') }}"
from: "/My Kestra Files/Inputs"
recursive: true
fetchType: FETCH
Properties
accessToken *Requiredstring
Dropbox access token
Token must allow listing the target path.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEFetch strategy
FETCH_ONE: return first entry.
FETCH (default): return all entries in memory.
STORE: stream entries to Kestra storage and return URI.
from Non-dynamicobject
Directory path
Literal Dropbox path. Empty or null lists the root. Should start with / when provided.
limit integerstring
2000Maximum entries
Default 2000. Passed to Dropbox API as limit.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
recursive booleanstring
falseRecursive listing
Default false. When true, traverses sub-folders.
Outputs
row
First entry
Populated when fetchType is FETCH_ONE.
io.kestra.plugin.dropbox.models.DropboxFile
date-timeClient modified time
Last modified timestamp from Dropbox. Null for folders.
Lower-cased path
Dropbox path_lower for the entry — the item's lower-cased path, not a stable unique ID.
Item name
Display path
Case-preserved display path from Dropbox.
Size in bytes
Null for folders.
Entry type
Either 'file' or 'folder'.
rows array
Directory entries
Populated when fetchType is FETCH.
io.kestra.plugin.dropbox.models.DropboxFile
date-timeClient modified time
Last modified timestamp from Dropbox. Null for folders.
Lower-cased path
Dropbox path_lower for the entry — the item's lower-cased path, not a stable unique ID.
Item name
Display path
Case-preserved display path from Dropbox.
Size in bytes
Null for folders.
Entry type
Either 'file' or 'folder'.
size integer
0Entry count
uri string
uriStored entries URI
Populated when fetchType is STORE.
Metrics
files.count counter
The number of files and folders found.
