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:
- Validates that a history item ID is provided
- Either uses the provided connection or creates a new client with direct API key
- Calls the ElevenLabs API to delete the history item
- 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