---
title: "Retrieve System Disk Usage"
method: GET
path: "/api/v1/system/df"
tags: ["System"]
---

# Retrieve System Disk Usage

`GET /api/v1/system/df`

Returns disk usage for the server storage directory.

## Query parameters

- `verbose` boolean

## Response `200`

Disk usage summary

- DiskUsageResponse — Disk usage summary for server-managed data.
  - `summary` DiskUsageSummaryRow[]
    - `type` string — Category name, such as runs or logs.
    - `count` integer — Number of items in the category.
    - `active` integer, nullable — Number of active items when applicable.
    - `size_bytes` integer — Total bytes used by the category.
    - `reclaimable_bytes` integer, nullable — Bytes reclaimable by pruning the category.
  - `total_size_bytes` integer — Total size of all tracked system data.
  - `total_reclaimable_bytes` integer — Total bytes reclaimable by deleting inactive runs and logs.
  - `runs` DiskUsageRunRow[], nullable — Per-run usage rows when verbose output is requested.
    - `run_id` string — Run identifier.
    - `workflow_name` string — Workflow display name.
    - `status` string — Current run status.
    - `start_time` string — Human-readable start timestamp.
    - `size_bytes` integer — Size used by the run scratch directory.
    - `reclaimable` boolean — Whether the run is inactive and reclaimable.

---

[API](https://skmtc.net/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.net/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/versions/bee030053823/schema)