---
title: "Update a voice in the voice library"
method: PATCH
path: "/v1/accounts/{accountId}/voice-library/{voiceId}"
tags: ["Voice Library"]
---

# Update a voice in the voice library

`PATCH /v1/accounts/{accountId}/voice-library/{voiceId}`

## Request body

- UpdateVoiceRequest — 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 `200`

Successful response

- GetVoiceResponse — Response for single voice endpoints.
  - `voice` VoiceResponse, required — A single voice as returned by the public API.
    - `id` string, required — Unique voice identifier
    - `name` string, required — Human-readable voice name
    - `provider` string, required — TTS provider
    - `providerVoiceId` string, required — Voice ID from the TTS provider
    - `config` object, required — Provider-specific voice config
    - `metadata` object — Additional voice metadata
    - `isPolyVoice` boolean — True if this is a Poly-curated voice (vs account-owned)

## Other responses

- `400` — Validation error
- `401` — Unauthorized – missing or invalid API key
- `403` — Forbidden – insufficient permissions
- `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)