Actions13
- Speech Actions
- Voice Actions
- History Actions
- User Actions
Overview
The Get History operation for the History resource in this custom n8n node allows users to retrieve a list of history items from the ElevenLabs API. This is useful for tracking previously generated speech, monitoring usage, or auditing past actions related to voice synthesis. Common scenarios include reviewing recent activity, paginating through large sets of history records, or filtering history by specific voices.
Practical examples:
- Fetching the last 100 speech generation events for reporting.
- Paginating through all history items to build an archive.
- Filtering history to show only items associated with a particular voice.
Properties
| Display Name | Type | Description |
|---|---|---|
| Notice | notice | Informational message about the node's beta status and links for more info/support. |
| Page Size | number | How many history items to return at maximum (cannot exceed 1000). |
| Last Item ID | string | The ID after which to start fetching; used for paginating across large collections of history items. |
| Voice ID | resourceLocator | The voice you want to use. Can be selected from a list or entered as an ID. |
Output
The output will be a JSON array of history items. Each item typically contains details such as:
history_item_id: Unique identifier for the history entry.voice_id: The voice used for the speech generation.date_created: Timestamp of when the event occurred.- Other metadata relevant to the speech generation event.
Note: The exact structure may depend on the ElevenLabs API response, but it will always be a collection of history entries with identifying and descriptive fields.
Dependencies
- External Service: Requires access to the ElevenLabs API.
- API Key: You must configure valid ElevenLabs API credentials in n8n under the name
elevenLabsApi. - n8n Configuration: No additional configuration required beyond setting up the credentials.
Troubleshooting
Common Issues:
- Invalid API Key: If your API key is missing or incorrect, requests will fail with authentication errors. Ensure your credentials are set up correctly in n8n.
- Page Size Exceeded: Setting "Page Size" above 1000 will likely result in an error or truncated results. Keep this value within allowed limits.
- Voice ID Not Found: Providing an invalid or non-existent Voice ID may result in empty results or an error from the API.
- Pagination Errors: If "Last Item ID" is incorrect or not present in your history, pagination may not work as expected.
Error Messages:
- 401 Unauthorized: Check your API credentials.
- 400 Bad Request: Review your input parameters, especially "Page Size" and "Voice ID".
- 404 Not Found: The specified "Last Item ID" or "Voice ID" does not exist.