# Update Voice

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /voices/{id}:
    put:
      summary: Update Voice
      deprecated: false
      description: Update a cloned voice by its ID
      tags:
        - API Reference/Voice Management
      parameters:
        - name: id
          in: path
          description: Voice id
          required: true
          schema:
            type: string
        - name: x-api-key
          in: header
          description: ''
          required: true
          example: <api-key>
          schema:
            type: string
        - name: version
          in: header
          description: ''
          required: false
          example: v1
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Voice name
                description:
                  type: string
                  description: Voice description
                gender:
                  type: string
                  description: Voice gender
                  enum:
                    - Male
                    - Female
                    - Neutral
                    - Unspecified
                  x-apidog-enum:
                    - value: Male
                      name: ''
                      description: ''
                    - value: Female
                      name: ''
                      description: ''
                    - value: Neutral
                      name: ''
                      description: ''
                    - value: Unspecified
                      name: ''
                      description: ''
                style:
                  type: string
                  description: Voice style(s), comma-separated
                accent:
                  type: string
                  description: Voice accent
              x-apidog-orders:
                - name
                - description
                - gender
                - style
                - accent
            example:
              name: Voice 1
              description: Happy voice with british accent
      responses:
        '204':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
                x-apidog-orders: []
          headers: {}
          x-apidog-name: No Content
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: object
                    properties:
                      error_code:
                        type: string
                      message:
                        type: string
                      extra:
                        type: object
                        properties:
                          field:
                            type: string
                        x-apidog-orders:
                          - field
                    required:
                      - error_code
                      - message
                    x-apidog-orders:
                      - error_code
                      - message
                      - extra
                required:
                  - detail
                x-apidog-orders:
                  - detail
              example:
                detail:
                  error_code: VOICE_FIELD_UPDATE_NOT_ALLOWED
                  message: Updating the 'name' field is not supported.
                  extra:
                    field: name
          headers: {}
          x-apidog-name: VOICE_FIELD_UPDATE_NOT_ALLOWED
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: object
                    properties:
                      error_code:
                        type: string
                      message:
                        type: string
                      extra:
                        type: object
                        properties:
                          api_key:
                            type: string
                        x-apidog-orders:
                          - api_key
                    required:
                      - error_code
                      - message
                    x-apidog-orders:
                      - error_code
                      - message
                      - extra
                required:
                  - detail
                x-apidog-orders:
                  - detail
              example:
                detail:
                  error_code: INVALID_API_KEY
                  message: Invalid or expired API key.
                  extra:
                    api_key: sk_33...
          headers: {}
          x-apidog-name: INVALID_API_KEY
        '404':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: object
                    properties:
                      error_code:
                        type: string
                      message:
                        type: string
                      extra:
                        type: object
                        properties:
                          voice_id:
                            type: string
                        x-apidog-orders:
                          - voice_id
                    required:
                      - error_code
                      - message
                    x-apidog-orders:
                      - error_code
                      - message
                      - extra
                required:
                  - detail
                x-apidog-orders:
                  - detail
              example:
                detail:
                  error_code: VOICE_NOT_FOUND
                  message: Requested voice with ID 17c7… not found.
                  extra:
                    voice_id: 17c7…
          headers: {}
          x-apidog-name: VOICE_NOT_FOUND
        '429':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: object
                    properties:
                      error_code:
                        type: string
                      message:
                        type: string
                      extra:
                        type: object
                        properties:
                          limit:
                            type: integer
                          retry_after_ms:
                            type: integer
                        x-apidog-orders:
                          - limit
                          - retry_after_ms
                    required:
                      - error_code
                      - message
                    x-apidog-orders:
                      - error_code
                      - message
                      - extra
                required:
                  - detail
                x-apidog-orders:
                  - detail
              example:
                detail:
                  error_code: RATE_LIMIT_EXCEEDED
                  message: Rate limit exceeded. Please try again later.
                  extra:
                    limit: 120
                    retry_after_ms: 8500
          headers: {}
          x-apidog-name: RATE_LIMIT_EXCEEDED
        '500':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  method:
                    type: string
                  url:
                    type: string
                  detail:
                    type: string
                required:
                  - message
                  - method
                  - url
                  - detail
                x-apidog-orders:
                  - message
                  - method
                  - url
                  - detail
              example:
                message: Oops! Internal server error occurred.
                method: POST
                url: /v1/tts/stream
                detail: 'Error: Traceback #42'
          headers: {}
          x-apidog-name: Server Error
        x-404:VERSION_NOT_FOUND:
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: object
                    properties:
                      error_code:
                        type: string
                      message:
                        type: string
                    required:
                      - error_code
                      - message
                    x-apidog-orders:
                      - error_code
                      - message
                required:
                  - detail
                x-apidog-orders:
                  - detail
              example:
                detail:
                  error_code: VERSION_NOT_FOUND
                  message: API version v0.9 not found.
          headers: {}
          x-apidog-name: VERSION_NOT_FOUND
      security: []
      x-apidog-folder: API Reference/Voice Management
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/909580/apis/api-16699700-run
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

```