Skip to main content

Overview

Delete a WhatsApp AI Agent from your workspace. Once deleted, the agent will no longer respond to incoming WhatsApp messages, and its configuration cannot be recovered.

Prerequisites

  • Bearer Token authentication
  • Valid WhatsApp Agent ID

Request

string
required
Bearer token for authenticated workspace access.
string
required
Unique identifier of the WhatsApp AI Agent to delete.

Response

boolean
Indicates whether the request completed successfully.
integer
HTTP status code returned by the API.
string
Confirmation message indicating the WhatsApp Agent was deleted successfully.

Error Handling

Deleting a WhatsApp Agent is permanent. Any conversations routed to this agent will stop being handled until another agent is assigned.
Before deleting a WhatsApp Agent, you may want to:
  • Retrieve the agent using GET /api/whatsapp/get-whatsapp-agent/{agentId}.
  • Export or save the agent configuration if needed.
  • Assign another WhatsApp Agent to the WhatsApp Business number to avoid service interruption.