Sign in
Settings

Get current disk usage for the control-plane server

Returns live disk usage for the monitored path along with any disks that meet or exceed the configured alert threshold. Read-only — does not send notifications. Used by the dashboard to surface a low-disk-space warning.

get/settings/disk-status

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/settings/disk-status
  • Auth: HTTP bearer

Response

Current disk usage and threshold alerts

checked_atstring date-time required

Timestamp of the check (ISO 8601, UTC)

enabledboolean required

Whether disk space monitoring is enabled in settings

threshold_percentinteger required

Configured alert threshold percentage (0-100)

Example response

{
  "checked_at": "2026-05-28T12:15:47.609192Z"
}

Changes

No recorded changes to this operation across all 50 revisions of this API.