---
title: "PUT /volumes/{name}"
method: PUT
path: "/volumes/{name}"
---

# PUT /volumes/{name}

`PUT /volumes/{name}`

"Update a volume. Valid only for Swarm cluster volumes"

## Path parameters

- `name` string, required

## Query parameters

- `version` integer, required

## Request body

- object
  - `Spec` ClusterVolumeSpec — Cluster-specific options used to create the volume.
    - `Group` string — Group defines the volume group of this volume. Volumes belonging to the same group can be referred to by group name when creating Services. Referring to a volume by group instructs Swarm to treat volumes in that group interchangeably for the purpose of scheduling. Volumes with an empty string for a group technically all belong to the same, emptystring group.
    - `AccessMode` object — Defines how the volume is used by tasks.
      - `Scope` 'single' | 'multi'
      - `Sharing` 'none' | 'readonly' | 'onewriter' | 'all'
      - `MountVolume` object
      - `Secrets` object[]
        - `Key` string
        - `Secret` string
      - `AccessibilityRequirements` object
        - `Requisite` object[]
        - `Preferred` object[]
      - `CapacityRange` object
        - `RequiredBytes` integer
        - `LimitBytes` integer
      - `Availability` 'active' | 'pause' | 'drain'

## Response `204`

There is no content to send for this request, but the headers may be useful.

## Changes

- **2026-02-14** `31f80d10d31a` — 2 breaking, 9 info
  - request body became required
  - removed the success response with the status `200`
  - api tag `Volume` removed
  - the `Availability` request property default value `active` was removed
  - …7 more

[Change history](https://skmtc.dev/hexlet/apis/docker-engine-api/changes/volumes/:name/put.md)

---

[API](https://skmtc.dev/hexlet/apis/docker-engine-api.md) · [All operations](https://skmtc.dev/hexlet/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexlet/docker-engine-api/revisions/7dbd508c79cf/schema)