Overview
This node integrates with the Tela API to dynamically execute a selected "canvas" within a specified project. It allows users to run predefined canvases (workflows or templates) hosted on the Tela platform, passing in custom variables as inputs. This is useful for automating tasks that are modeled as canvases in Tela, such as generating content, processing data, or triggering complex workflows.
Typical use cases include:
- Running a specific canvas in Tela to generate text or other outputs based on input variables.
- Automating interactions with Tela projects and canvases without manual intervention.
- Dynamically setting variables for each execution to customize the canvas behavior.
For example, a user might select a marketing project, choose a canvas designed to generate email copy, provide variables like product name and target audience, and then receive the generated content as output.
Properties
| Name | Meaning |
|---|---|
| Project | Select the Tela project containing your canvas. Options are loaded dynamically from the API. |
| Canvas | Select the specific canvas to execute within the chosen project. Options depend on the project. |
| Variables | Set one or more variables required by the selected canvas. Each variable has a name and a value. The list of variables is auto-populated based on the selected canvas. Variable values can be plain text or files. |
Output
The node outputs JSON data representing the result of executing the selected canvas with the provided variables. Specifically, the json output contains the content returned by the Tela API's completion endpoint, typically the generated or processed data from the canvas execution.
If any variable is a file type, the node processes it accordingly by uploading the file and passing a URL to the canvas. However, the output itself is JSON data reflecting the canvas execution result, not binary data.
Dependencies
- Requires an API key credential for authenticating with the Tela API.
- Depends on the Tela API service endpoints to:
- Load projects
- Load canvases within a project
- Load variables for a canvas
- Execute a canvas with variables
- No additional environment variables are explicitly required beyond the API key credential.
Troubleshooting
- Failed to load projects/canvases/variables: Indicates issues connecting to the Tela API or invalid credentials. Verify the API key is correct and has necessary permissions.
- Failed to execute canvas: Could be due to incorrect variable values, missing required variables, or API errors. Ensure all required variables are set and valid.
- File variable processing errors: If providing file variables, ensure the input binary data is correctly formatted and accessible. Errors here may cause fallback to string values.
- Empty or missing selections: The node requires selecting a project and canvas; leaving these empty will prevent execution.
Links and References
- Tela API Documentation (hypothetical link)
- n8n documentation on Creating Custom Nodes
- General info on Handling Binary Data in n8n
This summary is based solely on static analysis of the provided source code and property definitions.