---
title: "Disk usage for models"
method: GET
path: "/v1/models/storage"
tags: ["Models"]
---

# Disk usage for models

`GET /v1/models/storage`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/models/storage`
- Auth: HTTP bearer

## Response `200`

Storage info

- StorageInfo
  - `modelsDirectory` string, required
  - `modelCount` integer, required
  - `usedBytes` integer, required
  - `usedFormatted` string, required
  - `availableBytes` integer, required
  - `availableFormatted` string, required
  - `sharedBytes` integer: Bytes of `usedBytes` that another manager's name still holds (hardlinked adoptions); removing our entry frees nothing until the other tool releases it too.
  - `sharedFormatted` string
  - `reclaimableBytes` integer: What deleting our own entries would actually give back (`usedBytes` minus `sharedBytes`).
  - `reclaimableFormatted` string
  - `orphanedBytes` integer: Bytes in FluidAudio model directories ToolPiper wrote and no current code path reads, under the two FluidAudio cache roots. Report only; there is no delete verb for these and this figure is what the owner could reclaim by hand, never what a cleanup call would recover.
  - `orphanedFormatted` string
  - `orphaned` object[]: One entry per orphaned FluidAudio model directory. Directories in the shared vendor cache that ToolPiper cannot have written are not listed.
    - `path` string, required
    - `root` 'toolPiper' | 'libraryDefault', required
    - `bytes` integer, required
    - `reasons` string[], required

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)