---
title: "Replace audio file and voice tuning settings"
method: PUT
path: "/v1/agents/{agentId}/audio-cache/{entryId}/details"
tags: ["Audio Cache"]
---

# Replace audio file and voice tuning settings

`PUT /v1/agents/{agentId}/audio-cache/{entryId}/details`

Replace both the audio file and voice tuning settings for a cache entry in a single request. Sent as `multipart/form-data` with a `file` part containing the WAV audio (max 6 MB) and a `settings` part containing a JSON object with `text` and `config` fields.

## Response `204`

Audio and settings updated

## Other responses

- `400` — Invalid request. Returned when the `file` part is missing, the file exceeds the 6 MB limit, the `settings` part is not valid JSON, or the `entryId` is not a numeric ID.
- `401` — Unauthorized – missing or invalid API key
- `403` — Forbidden – the API key does not have `write` permission on the audio cache resource
- `404` — Resource not found

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/revisions/76f3c606e395/schema)