---
title: "Update Voice"
method: POST
path: "/v1/voices/update"
tags: ["voices"]
---

# Update Voice

`POST /v1/voices/update`

## Query parameters

- `id` string, uuid, required

## Request body

- union
  - AzureVoiceUpdateParams
    - `type` 'voice_azure', required
    - `voice_name` union
      - string
      - Undefined
    - `pitch` union
      - integer
      - Undefined
    - `rate` union
      - integer
      - Undefined
  - RimeVoiceUpdateParams
    - `type` 'voice_rime', required
    - `speaker` union
      - string
      - Undefined
    - `speed_alpha` union
      - number
      - Undefined
    - `model_id` union
      - 'mist' | 'v1'
      - Undefined
  - ElevenLabsVoiceUpdateParams
    - `type` 'voice_eleven_labs', required
    - `voice_id` union
      - string
      - Undefined
    - `stability` union
      - number
      - Undefined
    - `similarity_boost` union
      - number
      - Undefined
    - `api_key` union
      - string
      - Undefined
    - `optimize_streaming_latency` union
      - integer
      - Undefined
    - `model_id` union
      - string
      - Undefined
    - `experimental_input_streaming` union
      - boolean
      - Undefined
  - PlayHtVoiceUpdateParams
    - `type` 'voice_play_ht', required
    - `voice_id` union
      - string
      - Undefined
    - `api_user_id` union
      - string
      - Undefined
    - `api_key` union
      - string
      - Undefined
    - `version` union
      - '1' | '2'
      - Undefined
    - `speed` union
      - number
      - Undefined
    - `quality` union
      - 'faster' | 'draft' | 'low' | 'medium' | 'high' | 'premium'
      - Undefined
    - `temperature` union
      - number
      - Undefined
    - `top_p` union
      - number
      - Undefined
    - `text_guidance` union
      - number
      - Undefined
    - `voice_guidance` union
      - number
      - Undefined
    - `experimental_remove_silence` union
      - boolean
      - Undefined
  - VocodeVoiceUpdateParams
    - `type` 'voice_vocode', required
    - `voice_id` union
      - 'joe'
      - Undefined

## Response `200`

Successful Response

- union
  - AzureVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_azure', required
    - `voice_name` string, required
    - `pitch` integer
    - `rate` integer
  - RimeVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_rime', required
    - `speaker` string, required
    - `speed_alpha` number, nullable
    - `model_id` union
      - 'mist' | 'v1'
      - Undefined
  - ElevenLabsVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_eleven_labs', required
    - `voice_id` string, required
    - `stability` number, nullable
    - `similarity_boost` number, nullable
    - `api_key` string, nullable
    - `optimize_streaming_latency` integer, nullable
    - `model_id` string, nullable
    - `experimental_input_streaming` boolean
  - PlayHtVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_play_ht', required
    - `voice_id` string, required
    - `api_user_id` string, nullable
    - `api_key` string, nullable
    - `version` '1' | '2'
    - `speed` number, nullable
    - `quality` 'faster' | 'draft' | 'low' | 'medium' | 'high' | 'premium', nullable
    - `temperature` number, nullable
    - `top_p` number, nullable
    - `text_guidance` number, nullable
    - `voice_guidance` number, nullable
    - `experimental_remove_silence` boolean
  - VocodeVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_vocode', required
    - `voice_id` 'joe', required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vocodedev/apis/vocode-hosted-api.md) · [All operations](https://skmtc.net/vocodedev/apis/vocode-hosted-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vocodedev/vocode-hosted-api/revisions/ffca17c004e2/schema)