---
title: "Play Sound"
method: POST
path: "/api/media/play_sound"
---

# Play Sound

`POST /api/media/play_sound`

Play a sound file on the robot's speaker.

The *file* field can be:
- An absolute path on the daemon's filesystem.
- A filename relative to the built-in assets directory.
- A filename previously uploaded to the sounds temp directory.

## Request body

- PlaySoundRequest — Request body for the play_sound endpoint.
  - `file` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-03-25** `76bdd809b215` — 1 info
  - endpoint added
- **2026-03-03** `8d430e48a90a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/pollen-robotics/apis/reachy-mini-rest-api/changes/api/media/play_sound/post.md)

---

[API](https://skmtc.dev/pollen-robotics/apis/reachy-mini-rest-api.md) · [All operations](https://skmtc.dev/pollen-robotics/apis/reachy-mini-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pollen-robotics/reachy-mini-rest-api/revisions/7f5f936a81cc/schema)
