---
title: "Retrieve System Resources"
method: GET
path: "/api/v1/system/resources"
tags: ["System"]
---

# Retrieve System Resources

`GET /api/v1/system/resources`

Returns server-visible CPU, memory, and storage filesystem resource usage.

## Response `200`

System resource usage

- SystemResourcesResponse — Server-visible runtime resource usage for the active Fabro process environment.
  - `sampled_at` string, date-time, required — Timestamp when the sample was collected.
  - `cpu` SystemCpuResources, required — CPU resources visible to the Fabro server process.
    - `supported` boolean, required — Whether CPU metrics are available on this platform.
    - `scope` 'server_environment', required — Scope for CPU resource metrics.
    - `unavailable_reason` string, nullable, required — Reason metrics are unavailable when unsupported.
    - `logical_cpus` integer, nullable, required — Logical CPUs visible to the server process.
    - `usage_percent` number, double, nullable, required — CPU usage percentage, null until a delta sample is available.
    - `sample_window_ms` integer, nullable, required — Elapsed milliseconds since the previous CPU sample, null until a delta sample is available.
  - `memory` SystemMemoryResources, required — Memory resources visible to the Fabro server process.
    - `supported` boolean, required — Whether memory metrics are available on this platform.
    - `scope` 'host' | 'cgroup', required — `cgroup` when Linux cgroup limits are available, otherwise `host`.
    - `unavailable_reason` string, nullable, required — Reason metrics are unavailable when unsupported.
    - `total_bytes` integer, nullable, required — Total memory for the reported scope.
    - `used_bytes` integer, nullable, required — Used memory for the reported scope.
    - `available_bytes` integer, nullable, required — Available memory for the reported scope.
    - `used_percent` number, double, nullable, required — Used memory percentage for the reported scope.
    - `host_total_bytes` integer, nullable, required — Host total memory, included even when reporting a cgroup scope.
  - `disk` SystemDiskResources, required — Filesystem resources for the configured Fabro storage root.
    - `supported` boolean, required — Whether storage filesystem metrics are available.
    - `scope` 'storage_filesystem', required — Scope for disk resource metrics.
    - `unavailable_reason` string, nullable, required — Reason metrics are unavailable when unsupported.
    - `storage_path` string, required — Configured Fabro storage directory.
    - `mount_point` string, nullable, required — Mount point for the filesystem containing the storage directory.
    - `filesystem` string, nullable, required — Filesystem name reported by the operating system.
    - `total_bytes` integer, nullable, required — Total bytes on the storage filesystem.
    - `used_bytes` integer, nullable, required — Used bytes on the storage filesystem.
    - `available_bytes` integer, nullable, required — Available bytes on the storage filesystem.
    - `used_percent` number, double, nullable, required — Used percentage on the storage filesystem.
    - `fabro_managed_bytes` integer, required — Bytes managed by Fabro under the storage root.
    - `fabro_reclaimable_bytes` integer, required — Bytes reclaimable through Fabro pruning.
  - `notes` string[], required — Human-readable caveats about unavailable or scoped metrics.

---

[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/revisions/bee030053823/schema)