Remove the agent from a WhatsApp number

Remove the agent from one of the project's WhatsApp numbers, stopping automatic AI replies on that number. The agent keeps answering on its other numbers with their settings unchanged. The response is an object confirming the operation.

DELETE

https://api.nabrah.ai/api/ext/omni_v2/whatsapp/unassign_chatbot

curl --request DELETE \
  --url 'https://api.nabrah.ai/api/ext/omni_v2/whatsapp/unassign_chatbot' \
  --header 'X-API-Key: <your-api-key>'

// No example body for this response.

Effect

After unassigning, incoming WhatsApp messages on that number are no longer answered automatically by an AI agent.

Check the current assignment first with GET /api/ext/omni_v2/whatsapp/get_chatbot, and re-attach later with POST /api/ext/omni_v2/whatsapp/assign_chatbot.

Choosing the WhatsApp number

A project can connect more than one WhatsApp number. inbox_id selects the number this call works on.

One number

inbox_id is optional; the project's only WhatsApp number is used.

More than one number

inbox_id is required and the call returns 400 without it. An id that is not one of the project's WhatsApp numbers returns 404.

inbox_id

List the numbers and their ids with GET /api/ext/omni_v2/whatsapp/inboxes.

Errors

409 Conflict

Another change to the same number's agent is still being saved. Wait a moment, then try again; GET /api/ext/omni_v2/whatsapp/get_chatbot shows the result once it is saved.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Query parameters

inbox_idstring

The id of the WhatsApp number to use, from GET /api/ext/omni_v2/whatsapp/inboxes.

Use inboxes[].id (a UUID), not the numeric inboxes[].inbox_id. Optional while the project has one WhatsApp number; required once it has more than one.

Response

200

Successful Response

application/json

422

Validation Error

application/json