Skip to main content
PATCH
/
v1
/
accounts
/
{accountId}
/
voice-library
/
{voiceId}
Update a voice in the voice library
curl --request PATCH \
  --url https://api.us.poly.ai/v1/accounts/{accountId}/voice-library/{voiceId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "name": "<string>",
  "provider": "<string>",
  "config": {},
  "providerVoiceId": "<string>",
  "voiceMetadata": {}
}
'
{
  "voice": {
    "id": "<string>",
    "name": "<string>",
    "provider": "<string>",
    "providerVoiceId": "<string>",
    "config": {},
    "metadata": {},
    "isPolyVoice": false
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.poly.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
accountId
string
required
​
voiceId
string
required

Body

application/json

Request schema for updating a voice.

All fields are optional — only provided fields are patched.

​
name
string

Human-readable voice name

​
provider
string

TTS provider

​
config
object

Provider-specific voice config

​
providerVoiceId
string

Voice ID from the TTS provider

​
voiceMetadata
object

Additional voice metadata

Response

Successful response

Response for single voice endpoints.

​
voice
object
required

A single voice as returned by the public API.

Last modified on June 1, 2026