Actions20
Overview
The node interacts with the Tavus API to manage "replicas," which are AI-driven video avatars or models. Specifically, the List operation under the Replica resource retrieves a list of replicas from the Tavus platform. This operation supports filtering and pagination options, allowing users to fetch all replicas or limit the number returned, filter by replica type (user or system), specify particular replica IDs, and optionally include verbose details.
This node is useful in scenarios where you want to programmatically retrieve and manage your collection of AI replicas, for example:
- Displaying available replicas in a dashboard.
- Automating workflows that need to select or update specific replicas.
- Integrating replica data into other systems or reports.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all results or only up to a given limit. |
| Limit | Maximum number of results to return when not returning all (minimum 1, maximum 100). |
| Verbose | Include additional detailed data about each replica. |
| Replica Type | Filter replicas by type; options are: User or System. |
| Replica IDs | Comma-separated list of specific replica IDs to filter the results by. |
Output
The output is a JSON array containing replica objects retrieved from the Tavus API. Each object represents a replica with its associated properties. If the Verbose option is enabled, additional detailed information about each replica is included.
The node does not output binary data for this operation.
Dependencies
- Requires an active connection to the Tavus API using an API key credential configured in n8n.
- The node uses internal helper functions to make authenticated HTTP requests to the Tavus API endpoints.
Troubleshooting
- Invalid JSON in Properties: Although not directly relevant to the List operation, other operations require valid JSON input for some fields. Ensure JSON inputs are correctly formatted to avoid errors.
- API Authentication Errors: Make sure the API key credential is correctly set up and has sufficient permissions.
- Limit Exceeded: When not using "Return All," the limit must be between 1 and 100. Setting values outside this range may cause errors.
- Empty Results: If filters like Replica Type or Replica IDs are too restrictive, the result may be empty. Adjust filters accordingly.
- Network Issues: Connectivity problems with the Tavus API will cause request failures. Verify network access and API availability.
Links and References
- Tavus API Documentation (general reference for API endpoints and parameters)
- n8n Documentation on Creating Custom Nodes