---
title: "Play audio to a room"
method: POST
path: "/rooms/{id}/play"
tags: ["Rooms"]
---

# Play audio to a room

`POST /rooms/{id}/play`

## Request body

- union
  - object
    - `url` string, uri, required — URL of the audio file (mutually exclusive with tone)
    - `tone` string, required — Built-in telephone tone name. Format: {country}_{type} or bare {type} (defaults to US). Types: ringback, busy, dial, congestion. Countries: us, gb, de, fr, au, jp, it, in, br, pl, ru. Examples: us_ringback, gb_busy, dial.
    - `mime_type` string, required — MIME type (e.g. audio/wav). Required when using url.
    - `repeat` integer, required — Number of times to repeat playback (url only)
    - `volume` integer, required — Volume adjustment in dB (-8 to 8)
  - object
    - `url` string, uri, required — URL of the audio file (mutually exclusive with tone)
    - `tone` string, required — Built-in telephone tone name. Format: {country}_{type} or bare {type} (defaults to US). Types: ringback, busy, dial, congestion. Countries: us, gb, de, fr, au, jp, it, in, br, pl, ru. Examples: us_ringback, gb_busy, dial.
    - `mime_type` string, required — MIME type (e.g. audio/wav). Required when using url.
    - `repeat` integer, required — Number of times to repeat playback (url only)
    - `volume` integer, required — Volume adjustment in dB (-8 to 8)

## Response `200`

Playback started

- StatusResponse
  - `instance_id` string — Instance identifier
  - `status` string, required

## Other responses

- `400` — Invalid JSON or volume out of range
- `404` — Room not found
- `409` — Room has no participants

---

[API](https://skmtc.net/voiceblender/apis/voiceblender-api.md) · [All operations](https://skmtc.net/voiceblender/apis/voiceblender-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voiceblender/voiceblender-api/versions/ad30827d3b57/schema)