N8N Tools - Typebot API icon

N8N Tools - Typebot API

Complete Typebot.io integration - Self-hosted chatbot builder with visual flows
Join our community

Actions23

Overview

This node provides integration with Typebot.io, a self-hosted chatbot builder platform that allows creating and managing chatbots with visual flows. The node supports various operations on Typebot resources such as creating, updating, deleting, publishing, and duplicating chatbots (called "typebots"). It also manages chat sessions, conversation results, and workspace settings.

The Delete Typebot operation specifically deletes an existing typebot by its ID. This is useful for cleaning up unused or obsolete chatbots from your workspace.

Common scenarios:

  • Automating chatbot lifecycle management by programmatically deleting typebots no longer needed.
  • Integrating chatbot cleanup into broader workflows, e.g., removing test bots after deployment.
  • Managing workspace resources efficiently by deleting redundant chatbots.

Example:
You have a workflow that creates temporary chatbots for testing purposes. After tests complete, this node can delete those chatbots automatically to keep your workspace tidy.

Properties

Name Meaning
Typebot ID The unique identifier of the typebot to delete.
Additional Fields Optional extra parameters; not used in Delete Typebot operation but available for other ops.

Note: For the Delete Typebot operation, only the Typebot ID is required and relevant.

Output

The node outputs a JSON object representing the response from the Typebot API after attempting to delete the specified typebot.

  • If successful, the output typically contains confirmation details or an empty success response.
  • If the deletion fails, the output includes an error message describing the failure.

The output is structured as:

{
  "json": {
    // API response data or error message
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Typebot API.
  • Needs configuration of the Typebot API base URL and authentication token within the node credentials.
  • The node sends HTTP requests to the Typebot API endpoints to perform operations.

Troubleshooting

  • Error: Unknown typebot operation: deleteTypebot
    This indicates a misconfiguration or typo in the operation name. Ensure the operation is set exactly to "deleteTypebot".

  • API Authentication Errors
    If the API key or token is invalid or missing, the request will fail. Verify that the correct credentials are configured.

  • Typebot Not Found
    If the provided Typebot ID does not exist, the API will return an error. Confirm the ID is correct and the typebot exists.

  • Permission Denied
    Insufficient permissions in the workspace may prevent deletion. Check user roles and API token scopes.

  • Network Issues
    Connectivity problems to the Typebot API endpoint will cause failures. Ensure network access and correct API URL.

To resolve errors, check the error messages returned in the node output and verify all input parameters and credentials.

Links and References

Discussion