---
method: PUT
path: /api/media-items/:id/audio-speed
auth: jwt
area: media-items
---
<!-- source: internal/handlers/media.go:3033 MediaHandler.SetAudioSpeed -->

# Set Audio Speed

Persists the audiobook playback speed for the signed-in user on one media
item. Speed must be within **0.25–4.0** (NaN/Inf rejected).

## Example request

```json example-request
{
  "speed": 1.5
}
```

## Example response

```json example-response
{
  "playback_speed": 1.5
}
```

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 400 | `{"error": "invalid media item id"}` / `{"error": "invalid request"}` / `{"error": "speed out of range"}` | malformed or out-of-range |
| 401 | `{"error": "authentication required"}` / `{"error": "invalid user"}` | no/invalid auth |
| 404 | `{"error": "book not found"}` | no such media item |
| 500 | `{"error": "failed to save playback speed"}` | unexpected server error |