---
title: "Update Volume"
method: PATCH
path: "/control/volumes/{volume_name}"
tags: ["volumes", "control"]
---

# Update Volume

`PATCH /control/volumes/{volume_name}`

Update a volume
TODO: verify, that parameter are quoted correct

## Path parameters

- `volume_name` string, required

## Request body

- VolumeProperties — Volume properties that can be set for _update volume_ operation
  - `pool` string
  - `slot` integer
  - `volstatus` string
  - `volretention` string
  - `actiononpurge` string
  - `recycle` 'yes' | 'no' — An enumeration.
  - `inchanger` 'yes' | 'no' — An enumeration.
  - `maxvolbytes` string
  - `maxvolfiles` integer
  - `maxvoljobs` integer
  - `enabled` 'yes' | 'no' — An enumeration.
  - `recyclepool` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/bareos/apis/bareos-rest-api.md) · [All operations](https://skmtc.net/bareos/apis/bareos-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bareos/bareos-rest-api/versions/c6a9677e1448/schema)