Skip to main content

Edit Voice

Updates an existing voice's properties including name, description, labels, and audio samples.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.

Inputs​

  • Connection Id (String) - Connection ID from the Connect node. Optional if you provide API Key directly.
  • Voice ID (String) - ID of the voice to edit.
  • Name (String) - New name for the voice.
  • Files (Array) - Array of audio file paths to update the voice samples.

Options​

  • Description (String) - Optional description for the voice.
  • Labels (String) - Optional JSON string containing labels for the voice (e.g., {"accent": "American", "age": "young"}).
  • API Key - Your ElevenLabs AI API key. Optional if using Connection ID.

Outputs​

  • Voice (Object) - Updated voice information including:
    • voice_id - Voice identifier
    • name - Updated voice name
    • description - Updated description
    • labels - Updated labels
    • Other voice metadata

How It Works​

The Edit Voice node updates an existing voice. When executed, the node:

  1. Validates that voice ID, name, and files are provided
  2. Parses labels if provided (must be valid JSON)
  3. Either uses the provided connection or creates a new client with direct API key
  4. Prepares the audio file paths and parameters
  5. Calls the ElevenLabs API to update the voice
  6. Returns the updated voice information

Requirements​

  • Valid ElevenLabs API key (via Connect node or direct option)
  • Valid voice ID of an existing custom voice
  • Voice name
  • At least one audio file
  • Labels must be valid JSON if provided
  • You can only edit custom voices, not pre-made ElevenLabs voices

Error Handling​

The node will return specific errors in the following cases:

  • Missing voice ID - "Voice ID cannot be empty. Please provide a valid ElevenLabs voice ID."
  • Missing name - "Name cannot be empty. Please provide a name for the voice."
  • Missing files - "Files cannot be empty. Please provide at least one audio file."
  • Invalid labels - "Labels must be a valid JSON string (e.g., {"accent\": \"American"})."
  • Edit failure - "Failed to edit voice: [error details]"

Usage Notes​

  • Can only edit custom voices that you've created or cloned
  • Pre-made ElevenLabs voices cannot be edited
  • Updating audio files will retrain the voice with new samples
  • Use this to improve voice quality by adding better audio samples
  • Updating labels helps organize and categorize your voice library
  • The voice_id remains the same after editing
  • Any existing usage of the voice will use the updated version
  • Consider the impact on existing automations when updating a voice

Example Use Cases​

  • Improving voice quality by replacing low-quality audio samples
  • Updating voice metadata and labels for better organization
  • Renaming voices for clarity
  • Adding descriptions to document voice characteristics
  • Refining voice characteristics by providing additional samples
  • Correcting voice information after initial creation
  • Updating voice categories or use case labels