Skip to main content
GET
`GET /orgs/{org_id}/connectors/{connector_id}/browse/filesystems/search`

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
connector_id
string
required

Query Parameters

filesystem_ref
string
required

Filesystem root ref on the node (from /browse/filesystems).

path
string

Directory relative to the root; omit for the root itself.

pattern
string
required

Regex applied per line (Rust regex syntax; (?i) for case-insensitive).

glob
string

Filename glob (* and ?) restricting which files are scanned.

max_matches
integer<int32>

Match cap; the node clamps to its own ceiling.

Required range: x >= 0
timeout_ms
integer<int64>

Node-side scan budget in milliseconds (default 20000, ceiling 30000). 0 / omit = node default.

Required range: x >= 0

Response

Search completed

files_matched
integer<int64>
required
Required range: x >= 0
files_scanned
integer<int64>
required
Required range: x >= 0
matches
object[]
required
truncated
boolean
required

A cap bit (matches, files, bytes, or time) — matches is a prefix.