---
title: "Update Voice"
method: PATCH
path: "/v1/voices/{voice_id}"
---

# Update Voice

`PATCH /v1/voices/{voice_id}`

Update a voice you own.

## Path parameters

- `voice_id` string, required

## Request body

- UpdateVoiceRequest — Request body for updating an existing voice (partial update).
  - `name` string, nullable
  - `description` string, nullable
  - `generative_voice_description` string, nullable
  - `supported_languages` string[], nullable
  - `category` string, nullable
  - `age` string, nullable
  - `sex` string, nullable
  - `quality` string, nullable
  - `sample_text` string, nullable

## Response `200`

Successful Response

- VoiceDetailInfo — Extended voice metadata returned by CRUD endpoints.
  - `id` integer, required
  - `voice_id` integer, required
  - `handle` string, nullable
  - `public_id` string, nullable
  - `name` string, required
  - `description` string
  - `generative_voice_description` string
  - `supported_languages` string[]
  - `category` string
  - `age` string, nullable
  - `sex` string, nullable
  - `quality` string
  - `is_public` boolean
  - `verified` boolean
  - `pending_verification` boolean
  - `sample_url` string, nullable
  - `avatar_url` string, nullable
  - `sample_text` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/kugelaudio/apis/kugelaudio-tts-api.md) · [All operations](https://skmtc.net/kugelaudio/apis/kugelaudio-tts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kugelaudio/kugelaudio-tts-api/revisions/9ecca94b0377/schema)