Skip to main content
PUT
/
v1
/
agents
/
{agentId}
/
audio-cache
/
{entryId}
/
details
Replace audio file and voice tuning settings
curl --request PUT \
  --url https://api.us.poly.ai/v1/agents/{agentId}/audio-cache/{entryId}/details \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-KEY: <api-key>' \
  --form file='@example-file' \
  --form 'settings=<string>'

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
agentId
string
required
​
entryId
string
required

Audio cache entry ID

Body

multipart/form-data
​
file
file
required

WAV audio file (max 6 MB)

​
settings
string
required

JSON string with shape {"text": string, "config": VoiceTuningConfig}, where VoiceTuningConfig matches the VoiceTuningConfig schema. text is the transcript to associate with the cache entry; config carries provider-specific voice tuning settings.

Response

Audio and settings updated

Last modified on June 10, 2026