RetellAI icon

RetellAI

Interact with RetellAI API

Actions21

Overview

This node integrates with the RetellAI API, allowing users to perform various operations on different resources such as Agents, Calls, Concurrency settings, Knowledge Bases, and more. Specifically, for the Agent - Delete operation, it enables the deletion of an agent by specifying its unique Agent ID. This is useful in scenarios where you need to programmatically manage agents, such as removing outdated or inactive agents from your system.

Practical examples include:

  • Automating cleanup of agents that are no longer needed.
  • Managing agent lifecycle within a larger workflow that provisions and decommissions agents dynamically.

Properties

Name Meaning
Agent ID The unique identifier of the agent to delete. This is a required string input.

Output

The output of this node is a JSON object representing the result of the delete operation. Typically, this will confirm whether the deletion was successful or provide error details if it failed.

  • The json output field contains the response from the RetellAI API after attempting to delete the specified agent.
  • No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the RetellAI API.
  • Needs an API authentication token configured in n8n credentials (referred generically as "an API key credential").
  • The base URL used for requests is https://api.retellai.com.
  • The node expects the "Content-Type" header to be set to application/json.

Troubleshooting

  • Common issues:

    • Invalid or missing Agent ID: Ensure the Agent ID provided is correct and exists in the RetellAI system.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Network or connectivity problems: Check internet access and RetellAI service status.

  • Error messages:

    • "error": "Agent not found": The specified Agent ID does not exist; verify the ID.
    • "error": "Unauthorized": Authentication failed; check API credentials.
    • Other HTTP errors may indicate rate limits or server issues; retry or consult RetellAI support.

Links and References

Discussion