Actions29
Overview
This node integrates with the BookedIn AI platform to manage various resources such as agents, leads, lists, strategies, campaigns, and human messages. Specifically, for the Agent - Delete operation, it allows users to delete an existing AI agent by specifying its unique Agent ID.
Typical use cases include:
- Removing obsolete or inactive AI agents from your BookedIn account.
- Automating cleanup of agents that are no longer needed in workflows.
- Managing lifecycle of AI agents programmatically within n8n automation flows.
Example: You have an AI agent created for a specific sales campaign that has ended. Using this node’s delete operation, you can remove that agent automatically when the campaign finishes.
Properties
| Name | Meaning |
|---|---|
| Agent ID | The unique identifier of the agent to delete (e.g., ag_a1b2c3d4e5f6). This is required to specify which agent should be deleted. |
Output
The output JSON contains the response from the BookedIn API after attempting to delete the specified agent. Typically, this will be an empty object or confirmation message indicating successful deletion.
If the deletion fails, the output will contain an error message describing the issue.
No binary data is produced by this operation.
Dependencies
- Requires an active API key credential for authenticating with the BookedIn API.
- The node makes HTTP requests to the BookedIn API endpoint at
https://api.bookedin.ai/api/v1/agents/{agentId}using the DELETE method. - Proper network connectivity to the BookedIn API service is necessary.
Troubleshooting
Common issues:
- Providing an invalid or non-existent Agent ID will result in an error from the API.
- Missing or incorrect API authentication credentials will cause authentication failures.
- Network issues or API downtime may prevent successful deletion.
Error messages and resolutions:
"Agent not found": Verify the Agent ID is correct and exists in your BookedIn account."Authentication failed": Check that the API key credential is correctly configured and valid."Invalid Agent ID format": Ensure the Agent ID matches the expected pattern (e.g., starts withag_).- JSON parsing errors or unexpected responses usually indicate API changes or connectivity problems.
Links and References
- BookedIn API Documentation (for detailed API endpoints and usage)
- n8n HTTP Request Node Documentation (for understanding HTTP request handling in n8n)
- BookedIn Official Website