View as Markdown
Dropbox icon

Dropbox ACTION

Search files and folders

Searches for files and folders by name. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Dropbox account once, then configure and run Search files and folders from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "dropbox-search-files-folders",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    dropbox: { authProvisionId: "apn_xxxxxxx" },
    query: "Query",
    path: "Path",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search files and folders inputs
Property Type Description
query Query string
The string to search for. May match across multiple fields based on the request arguments.
Required
path Path string
Type the folder name to search for it in the user's Dropbox.
Required Dynamic
orderBy Order By string
By default, results are sorted by relevance.
Optional
fileStatus File Status string
Restricts search to the given file status.
Optional
filenameOnly Filename Only boolean
Restricts search to only match on filenames.
Optional
fileCategories File Categories string[]
Restricts search to only the file categories specified. Only supported for active file search.
Optional
fileExtensions File Extensions string[]
Restricts search to only the extensions specified. Only supported for active file search.
Optional
includeHighlights Include Highlights boolean
Whether to include highlight span from file title.
Optional
limit Limit integer
Specify a max amount of register to be fetched. Defaults to 100 if left blank.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
dropbox-search-files-folders
Version
0.0.15
App
Dropbox
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes