---
title: "Update Voice"
method: PUT
path: "/voices/{voice_id}"
tags: ["Synth Voices"]
---

# Update Voice

`PUT /voices/{voice_id}`

Update mutable metadata fields of a voice.

Invalidates the ``user_voice`` and ``user_voice_preview`` Redis cache entries for
the affected voice after a successful update.

Args:
    voice_id: UUID of the voice to update.
    payload: Fields to update (name, description, style, etc.).
    token: Authenticated token with user context.
    _request: Raw FastAPI ``Request``.
    version: API version extracted from the ``version`` request header.
    x_api_key: Bearer API key (used as a cache-key component for invalidation).

Returns:
    None: HTTP 204 No Content on success.

## Path parameters

- `voice_id` string, uuid, required

## Headers

- `version` 'v1'
- `X-Api-Key` string

## Request body

- VoiceUpdateRequest
  - `name` string, nullable
  - `description` string, nullable
  - `gender` 'Male' | 'Female' | 'Neutral' | 'Unspecified'
  - `accent` string, nullable
  - `style` string, nullable
  - `is_active` boolean, nullable
  - `language` string, nullable

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/async/apis/text-to-speech-api-service.md) · [All operations](https://skmtc.dev/async/apis/text-to-speech-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/async/text-to-speech-api-service/revisions/9bfc541b6e9a/schema)