v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01206322659.2 KB
connectors

`GET /orgs/{org_id}/connectors/{connector_id}/browse/filesystems/summary`

Summarize a directory tree on a connector filesystem root without listing it: file/dir counts, total bytes, largest files, extension histogram. The probe to run before a recursive copy. Requires fs:browse (0.1.27+).

get/orgs/{org_id}/connectors/{connector_id}/browse/filesystems/summary

Path parameters

org_idstring required
connector_idstring required

Query parameters

filesystem_refstring required

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

pathstring

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

timeout_msinteger

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

Response

Tree summarized

dir_countinteger required
file_countinteger required
max_depthinteger required

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

total_bytesinteger required

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

truncatedboolean required

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

truncated_reasonstring nullable