---
title: "Lightweight PocketBase volume info"
method: GET
path: "/apps/{appRef}/pocketbase/volume"
tags: ["Data"]
---

# Lightweight PocketBase volume info

`GET /apps/{appRef}/pocketbase/volume`

## Request

- Base URL: `https://api.percher.run`
- URL: `https://api.percher.run/apps/{appRef}/pocketbase/volume`
- Auth: HTTP bearer

Returns the PB volume name, size in MB, and sidecar status — the subset of `/topology` that the dashboard Data tab needs. Cheaper than the full topology graph (no Caddy + Docker fan-out). `sizeMb` comes from the 60s-cached `du -sb` measurement inside the live container; null when PB is absent, stopped, or the probe failed.

## Path parameters

- `appRef` string, required

## Response `200`

Volume info

- object
  - `volumeName` string, required
  - `sizeMb` number, nullable, required
  - `status` 'healthy' | 'down' | 'absent', required
  - `note` string

---

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