***

title: volume
slug: /reference/python/relay/actions/play-action/volume
description: Adjust audio playback volume.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

Adjust the playback volume.

## **Parameters**

<ParamField path="volume" type="float" required={true} toc={true}>
  Volume adjustment in dB. Range: `-40.0` to `40.0`.
</ParamField>

## **Returns**

`dict` -- Server acknowledgment.

## **Example**

```python {19,22}
from signalwire.relay import RelayClient

client = RelayClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
    contexts=["default"],
)

@client.on_call
async def handle_call(call):
    await call.answer()
    action = await call.play(
        [{"type": "audio", "url": "https://example.com/hold-music.mp3"}],
        loop=0,
    )

    # Increase volume
    await action.volume(10.0)

    # Decrease volume
    await action.volume(-5.0)

client.run()
```