---
title: "Play audio"
method: POST
path: "/v1/calls/{id}/play"
tags: ["Call control"]
---

# Play audio

`POST /v1/calls/{id}/play`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/calls/{id}/play`
- Auth: HTTP bearer

Plays an audio prompt into the active call identified by `id`. The audio is audible to the remote party in real time.

## Path parameters

- `id` string, uuid, required

## Request body

- CallAudioPlayRequest
  - `audio_file` string, required: URL of the audio file to play to the call.

## Response `200`

Returns a success confirmation. Audio playback starts.

- SuccessResponse
  - `success` boolean, required: Indicates whether the request was successful.

## Other responses

- `400`: Returns a validation error when a request parameter is invalid.
- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.
- `404`: Request failed. An object with the specified ID is not found.

## Changes

- **2026-09-08** `6a89c962481c`: 1 info
  - added the non-success response with the status `403`

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/calls/:id/play/post.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)