---
title: "List manageable volumes"
method: GET
path: "/v3/manageable_volumes"
tags: ["manageable-volumes"]
---

# List manageable volumes

`GET /v3/manageable_volumes`

Lists all manageable volumes

## Query parameters

- `host` string, required
- `cluster` string
- `sort` string
- `sort_key` string
- `sort_dir` 'asc' | 'desc'
- `limit` integer
- `offset` integer
- `marker` string

## Response `200`

OK

- ManageableVolumes
  - `manageable-volumes` ManageableVolumeSimple[]
    - `reference` object — Driver-specific reference object
    - `size` integer — Size of the volume in GB
    - `safe_to_manage` boolean — Whether the volume is safe to manage
    - `reason_not_safe` string, nullable — Reason why volume is not safe to manage
    - `cinder_id` string, uuid, nullable — Cinder volume UUID if already managed
    - `extra_info` string, nullable — Additional information

---

[API](https://skmtc.net/platform9/apis/cluster-blueprint-api.md) · [All operations](https://skmtc.net/platform9/apis/cluster-blueprint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/platform9/cluster-blueprint-api/revisions/708ad90fe444/schema)