Skip to main content

Delete History Item

Permanently deletes a history item from your ElevenLabs account.

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.
  • History Item ID (String) - ID of the history item to delete.

Options

  • API Key - Your ElevenLabs AI API key. Optional if using Connection ID.

Outputs

This node does not have outputs.

How It Works

The Delete History Item node removes a history entry. When executed, the node:

  1. Validates that a history item ID is provided
  2. Either uses the provided connection or creates a new client with direct API key
  3. Calls the ElevenLabs API to delete the history item
  4. Removes the item from your generation history

Requirements

  • Valid ElevenLabs API key (via Connect node or direct option)
  • Valid history item ID

Error Handling

The node will return specific errors in the following cases:

  • Missing history item ID - "History Item ID cannot be empty. Please provide a valid history item ID."
  • Deletion failure - "Failed to delete history item: [error details]"

Usage Notes

  • This action is permanent and cannot be undone
  • Deleting a history item also deletes its associated audio
  • The audio file will no longer be available for download
  • Use this to manage your history and free up storage
  • History item IDs come from the Get History node
  • Consider downloading the audio before deletion if you might need it later
  • Deletion may help manage account storage limits
  • Useful for cleaning up test or unwanted generations

Example Use Cases

  • Cleaning up test or experimental generations
  • Managing history storage limits
  • Removing unwanted or failed generations
  • Maintaining a clean history log
  • Batch cleaning old history items
  • Removing generations with errors
  • Managing account storage usage