# check_disk_usage

> Report the largest directories under an account's home, largest first, as `directories[{path, sizeMb, sizeGb}]` (`unit: MB`; every directory of 1 MB and up, at most…

- Tier: R
- Required scope: read:hosting
- Annotations: readOnlyHint, idempotentHint
- Docs: https://api.inleed.com/tools/check-disk-usage

## Description

Report the largest directories under an account's home, largest first, as `directories[{path, sizeMb, sizeGb}]` (`unit: MB`; every directory of 1 MB and up, at most 60) — the "what is filling my disk" answer. Optionally narrow with a `path` prefix and cap with `limit`. An empty list means the home holds no directory of 1 MB or more, not a failure. This lists directory sizes, not individual files, and does not delete anything.

## Input schema

- `input` — string (required). A domain, email address, website URL, numeric service id, or hosting-account username the customer actually owns. Resolved to the owning account automatically; the resolved target is echoed back in the response.
- `path` — string. Only report directories under this path, relative to the account home (e.g. domains/example.com).
- `limit` — integer. Maximum number of directories to return, largest first. Default 25. Range 1–200.

## Example call

```json
{
  "name": "check_disk_usage",
  "arguments": {
    "input": "example.se"
  }
}
```

## Example conversation

**User:** What is taking up space?

**Assistant:** Largest: wp-content/uploads 41 GB, of which backup-2024 is 38 GB. Then logs at 1.2 GB.