Dropbox Search
CertifiedSearch Dropbox files and folders
Dropbox Search
Search Dropbox files and folders
Searches Dropbox for a query under an optional path. Path must start with / if provided and can come from kestra:// URI. Supports extension filters, max results, and fetchType (default FETCH) controlling memory vs storage output.
type: io.kestra.plugin.dropbox.files.SearchExamples
Search for files matching a query.
id: dropbox_search
namespace: company.team
tasks:
- id: search_for_reports
type: io.kestra.plugin.dropbox.files.Search
accessToken: "{{ secret('DROPBOX_ACCESS_TOKEN') }}"
query: "report.csv"
path: "/reports"
fetchType: FETCH
Properties
accessToken *Requiredstring
Dropbox access token
Token must allow search within the specified scope.
query *Requiredstring
Search query
fetchType string
FETCHSTOREFETCHFETCH_ONENONEFetch strategy
FETCH_ONE: return first match.
FETCH (default): return all matches in memory.
STORE: stream matches to Kestra storage and return URI.
fileExtensions array
File extensions filter
Restrict results to listed extensions, e.g., jpg, csv.
maxResults integerstring
Maximum results
path Non-dynamicobject
Search path (optional)
Literal Dropbox path or kestra:// URI containing the path. Must start with / when set.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
Outputs
row
First search result
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
Search results
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
0Result count
uri string
uriStored results URI
Populated when fetchType is STORE.
Metrics
files.count counter
The number of matching files and folders found.
