Files

Search files

Search files by content or filename using ripgrep.

Parameters#

querystringrequired

Pattern or fragment to search.

locationstringdefault: USER

USER | CONVERSATION | ALL_CONVERSATIONS (default USER).

case_sensitivebooleandefault: true

If true (default), search is case-sensitive; if false, case-insensitive.

exclude_patternstringdefault: ""

Glob pattern to exclude (e.g. 'node_modules/**').

include_patternstringdefault: ""

Glob pattern to include (e.g. '**/*.py').

search_kindstringdefault: content

'content' or 'filename'.

devicestringdefault: ""

Optional fleet device name or id. When set, searches that running device's filesystem instead of the host (only location='USER' is supported for devices). The device must be started first. Requires the 'devices:manage' scope.

zappstringdefault: ""

Optional Zo App slug or id. When set, searches that Zo App's sandbox filesystem instead of the host (only location='USER' is supported). Mutually exclusive with 'device'. Requires the 'apps:shell' scope.