Skip to main content

Get History Item

Retrieves detailed information about a specific history item by its ID.

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 retrieve.

Options​

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

Outputs​

  • History Item (Object) - Detailed history item information including:
    • history_item_id - Unique identifier
    • text - Original text that was converted
    • voice_id - Voice used for generation
    • voice_name - Name of the voice
    • model_id - Model used for generation
    • voice_settings - Settings used (stability, similarity_boost)
    • date_unix - Generation timestamp
    • character_count_change_from - Starting character count
    • character_count_change_to - Ending character count
    • content_type - Audio format
    • state - Generation state
    • feedback - User feedback if any

How It Works​

The Get History Item node retrieves detailed information about a specific generation. 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 retrieve the history item
  4. Returns the complete history item details including generation settings

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."
  • Retrieval failure - "Failed to retrieve history item: [error details]"

Usage Notes​

  • Returns more detailed information than Get History
  • Includes the exact settings used for generation
  • Useful for reproducing a specific generation
  • The text and settings can be used to regenerate similar audio
  • History item IDs come from the Get History node
  • Use this to inspect the parameters of past generations
  • The voice_settings show what stability and similarity boost were used

Example Use Cases​

  • Inspecting settings of a successful generation to reproduce quality
  • Debugging why a generation succeeded or failed
  • Auditing specific audio generations
  • Retrieving the exact text used for a past generation
  • Checking which voice and settings were used
  • Building detailed generation reports
  • Reproducing past generations with the same settings