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

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.

timeout_ms
integer<int64>

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

Required range: x >= 0

Response

Tree summarized

by_extension
object[]
required

Per-extension rollup, by bytes descending.

dir_count
integer<int64>
required
Required range: x >= 0
file_count
integer<int64>
required
Required range: x >= 0
largest
object[]
required

Top-N files by size, descending.

max_depth
integer<int32>
required

Deepest directory level seen (the walk root = 0).

Required range: x >= 0
total_bytes
integer<int64>
required

Sum of regular-file sizes seen (symlinks excluded).

Required range: x >= 0
truncated
boolean
required

The walk hit a cap — every count is a floor, not a total.

truncated_reason
string | null