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

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.

all
boolean

Include dotfiles.

sort
string

name (default) | size (largest first) | mtime (newest first).

glob
string

Filename glob (* and ?), matched on entry names.

depth
integer<int32>

0 (default) = this directory only; 1..N = bounded recursion that many levels deeper (clamped node-side).

Required range: x >= 0
limit
integer<int32>

Entry cap; the node clamps to its own ceiling and flags truncated.

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

Node-side walk budget in milliseconds (default 20000, ceiling 30000). 0 / omit = node default. Channel wait is 35s so a full budget still returns a truncated listing instead of browse_timeout.

Required range: x >= 0

Response

Directory listed

entries
object[]
required
truncated
boolean
required

The entry cap bit — entries is a prefix of the real listing.