Search for files and folders in Dropbox.
type: "io.kestra.plugin.dropbox.files.Search"Examples
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: "{{ secrets.DROPBOX_ACCESS_TOKEN }}"
query: "report.csv"
path: "/reports"
fetchType: FETCH
Properties
accessToken *Requiredstring
Dropbox access token.
query *Requiredstring
The string to search for.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEHow to fetch the data.
FETCH_ONE: Returns a single row. FETCH: Returns all rows in memory. STORE: Returns all rows in a file stored in Kestra's internal storage.
fileExtensions array
Restricts search to only files with the given extensions (e.g., 'jpg', 'png').
maxResults integerstring
The maximum number of results to return.
path Non-dynamicobject
The path to search in (optional).
Can be a direct path as a string, or a Kestra internal storage URI (kestra://...) of a file containing the path.
Outputs
row DropboxFile
The first search result found.
Only populated if fetchType is FETCH_ONE.
size integer
0The number of results found.
uri string
uriThe URI of the file in Kestra's internal storage.
Only populated if fetchType is STORE.
Definitions
io.kestra.plugin.dropbox.models.DropboxFile
clientModified string
date-timeThe last time the file was modified on Dropbox.
id string
The unique ID of the file or folder.
name string
The file or folder name.
path string
The lower-case version of the path for display.
size integer
The file size in bytes.
Null for folders.
type string
The type of the entry.
Can be 'file' or 'folder'.