***

title: volume
slug: /reference/typescript/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="number" required={true} toc={true}>
  Volume adjustment in dB. Range: `-40.0` to `40.0`.
</ParamField>

## **Returns**

`Promise<Record<string, unknown>>` -- Server acknowledgment.

## **Example**

```typescript {17,20}
import { RelayClient } from '@signalwire/sdk';

const client = new RelayClient({
  project: process.env.SIGNALWIRE_PROJECT_ID!,
  token: process.env.SIGNALWIRE_TOKEN!,
  contexts: ['default']
});

client.onCall(async (call) => {
  await call.answer();
  const 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);
});

await client.run();
```