Skip to main content
PATCH
/
v2
/
volumes
/
{volumeId}
Update Volume
curl --request PATCH \
  --url https://api.tusky.io/v2/volumes/{volumeId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "publisherIds": [
    {}
  ]
}
'
Update a volume’s settings. Only included fields are changed.

​
Path Parameters

​
volumeId
string
required
The volume ID.

​
Request Body

​
name
string
New volume name.
​
publisherIds
array
Replace the assigned publishers. Pass an array of publisher IDs. Multiple publishers enable horizontal scaling — uploads are distributed across them for shorter publishing times. Set to [] to revert to the account default publisher.

​
Response

Returns the updated volume object.

​
Example

curl -X PATCH https://api.tusky.io/v2/volumes/vol_abc123 \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"publisherIds": ["pub_primary", "pub_secondary", "pub_tertiary"]}'

​
Response

{
  "id": "vol_abc123",
  "name": "Production Assets",
  "encrypted": false,
  "publisherIds": ["pub_primary", "pub_secondary", "pub_tertiary"],
  "updatedAt": "2026-03-07T15:00:00Z"
}
The encrypted flag cannot be changed after creation.