---
title: "Upload Sound"
method: POST
path: "/api/media/sounds/upload"
---

# Upload Sound

`POST /api/media/sounds/upload`

Upload a sound file to the daemon's temporary sound directory.

The file is saved to ``/tmp/reachy_mini_sounds/<original_filename>``.
If a file with the same name already exists it is overwritten.

The upload is restricted to known audio extensions, capped at
``MAX_SOUND_UPLOAD_BYTES``, and validated by content before being stored,
so non-audio payloads cannot be written to disk.

Returns:
    JSON with the absolute *path* of the saved file on the daemon.

## 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/sounds/upload/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)