> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weya.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete WhatsApp Number

> Remove a WhatsApp Business number from your Weya AI workspace.

## Overview

Delete an existing WhatsApp Business integration from your workspace. Once deleted, the WhatsApp number will no longer receive or send messages through Weya AI, and any associated WhatsApp Agents must be reassigned before they can be used again.

## Prerequisites

* Bearer Token authentication
* Valid WhatsApp Phone Number ID

## Request

<ParamField header="Authorization" type="string" required>
  Bearer token for authenticated workspace access.
</ParamField>

<ParamField path="phoneNumberId" type="string" required>
  Unique identifier of the WhatsApp Business phone number to delete.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request DELETE '{{baseUrl}}/api/whatsapp/delete-whatsapp-number/123456789012345' \
  --header 'Authorization: Bearer {{authToken}}'
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "status": true,
    "code": 200,
    "message": "WhatsApp number deleted successfully"
  }
  ```
</ResponseExample>

<ResponseField name="status" type="boolean">
  Indicates whether the request completed successfully.
</ResponseField>

<ResponseField name="code" type="integer">
  HTTP status code returned by the API.
</ResponseField>

<ResponseField name="message" type="string">
  Confirmation message indicating the WhatsApp number was removed successfully.
</ResponseField>

## Error Handling

| Status | Description                                                    |
| ------ | -------------------------------------------------------------- |
| 400    | Invalid WhatsApp Phone Number ID                               |
| 401    | Unauthorized or invalid Bearer token                           |
| 403    | You do not have permission to delete this WhatsApp integration |
| 404    | WhatsApp integration not found                                 |
| 500    | Internal server error                                          |

<Warning>
  Deleting a WhatsApp number removes its integration from your workspace. Any WhatsApp Agents assigned to this number should be reassigned before deleting the integration.
</Warning>

<Check>
  Before deleting a WhatsApp number, you may want to:

  * Retrieve all connected WhatsApp numbers using `GET /api/whatsapp/whatsapp-number`.
  * Remove or reassign any WhatsApp Agent linked to the number.
  * Export any required configuration or templates associated with the integration.
</Check>