Repo Operations
resource: repo — stat and garbageCollect: local repository maintenance
stat
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
sizeOnly | bool | No | false | Skip the (potentially expensive) object-count computation for a faster size-only response. |
Response: { repoSizeBytes, storageMaxBytes, numObjects, repoPath, version } —
numObjects is 0/meaningless when sizeOnly=true.
garbageCollect
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
confirmDestructive | bool | ✓ Yes | false | Explicit operator confirmation that this run should permanently delete unpinned blocks. Must be true for the call to proceed. |
Permanently deletes unpinned blocks. When
confirmDestructive is not
true, the call is rejected before any HTTP request is made, with
CFG_CONFIRM_REQUIRED ("repo/gc permanently deletes unpinned blocks and cannot be undone —
set 'confirmDestructive' = true to proceed."). Anything you want to keep must be pinned (see
Pin Operations) before running this.