ElevenLabs icon

ElevenLabs

WIP

Actions16

Overview

The "Get History" operation of the ElevenLabs node retrieves a list of history items related to previous interactions or actions performed via the ElevenLabs API. This operation is useful for auditing, reviewing past requests, or implementing pagination over historical data.

Typical use cases include:

  • Fetching recent voice synthesis or speech generation history.
  • Paginating through large sets of history records to analyze usage patterns.
  • Integrating with dashboards or logs that display user activity or system events.

Properties

Name Meaning
Page Size Maximum number of history items to return (up to 1000). Controls the size of each page of results.
Last Item ID The ID after which to start fetching history items. Used for paginating through large collections.
Voice ID Selects the specific voice associated with the history items. Can be chosen from a searchable list or by entering an ID manually.

Additionally, there is a notice property informing users that this node is in BETA and under active development, with links for more information and support.

Output

The output contains a JSON field with the retrieved history items. Each item represents a record from the user's history on the ElevenLabs platform, likely including metadata such as timestamps, associated voice IDs, and details about the action performed.

If binary data is returned (not explicitly shown in the provided code), it would typically represent audio files or other media related to the history entries.

Dependencies

  • Requires an API key credential for authenticating with the ElevenLabs API.
  • The node makes HTTP POST requests to https://api.elevenlabs.io/v1.
  • No additional external dependencies are indicated beyond the ElevenLabs API access.

Troubleshooting

  • Common issues:

    • Exceeding the maximum allowed page size (over 1000) will likely cause errors.
    • Providing an invalid or expired API key will result in authentication failures.
    • Incorrect or non-existent last_history_item_id values may lead to empty results or errors.
    • Selecting a voice_id that does not exist or is not accessible by the user may cause no matching history items to be returned.

  • Error messages:

    • Authentication errors: Check that the API key credential is correctly configured and valid.
    • Pagination errors: Ensure page_size is within allowed limits and last_history_item_id corresponds to a valid existing item.
    • Network or API errors: Verify network connectivity and that the ElevenLabs API service is operational.

Links and References

Discussion