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 *string
Dropbox access token
Token must allow search within the specified scope.
query *string
Search query
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
{}1150fetchType 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 object
Search path (optional)
Literal Dropbox path or kestra:// URI containing the path. Must start with / when set.
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.
Media info
Photo or video metadata. Only populated by GetMetadata with includeMediaInfo: true.
io.kestra.plugin.dropbox.models.DropboxMediaInfo
Video duration in milliseconds
Null for photos.
Height in pixels
GPS latitude
GPS longitude
falsePending
True when Dropbox has not finished extracting the media info yet; other fields are then null.
date-timeTime the photo or video was taken
Media type
Either 'photo' or 'video'. Null while Dropbox is still extracting the media info.
Width in pixels
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.
Media info
Photo or video metadata. Only populated by GetMetadata with includeMediaInfo: true.
io.kestra.plugin.dropbox.models.DropboxMediaInfo
Video duration in milliseconds
Null for photos.
Height in pixels
GPS latitude
GPS longitude
falsePending
True when Dropbox has not finished extracting the media info yet; other fields are then null.
date-timeTime the photo or video was taken
Media type
Either 'photo' or 'video'. Null while Dropbox is still extracting the media info.
Width in pixels
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.
