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

# Delete Contact: Permanently Remove a Contact Record

> Permanently delete a contact from your ChatbotX Workspace using their internal ID, email address, or phone number as the identifier.

The Delete Contact endpoint permanently removes a contact and all associated records from your Workspace. This action is irreversible — the contact's conversation history, custom field values, tags, and notes are deleted. Use this endpoint only when you intend a full removal; to simply block a contact from sending messages, use the block endpoint instead. A successful deletion returns HTTP `204 No Content`.

<Info>
  **DELETE** `/api/v1/contacts/{identifier}`
</Info>

<Warning>
  Deleting a contact is permanent and cannot be undone. Verify the identifier resolves to the correct contact before sending this request.
</Warning>

## Path Parameters

<ParamField path="identifier" type="string" required>
  A contact lookup string using one of the three supported prefix formats. Minimum length: 1 character.

  | Format          | Example                  |
  | --------------- | ------------------------ |
  | `id:<value>`    | `id:123456789`           |
  | `email:<value>` | `email:user@example.com` |
  | `phone:<value>` | `phone:+84708123123`     |
</ParamField>

## Code Examples

<CodeGroup>
  ```bash curl theme={null}
  curl --request DELETE \
    --url "https://app.chatbotx.io/api/v1/contacts/email:user@example.com" \
    --header "Authorization: Bearer YOUR_API_TOKEN"
  ```

  ```python Python theme={null}
  import requests

  identifier = "email:user@example.com"
  url = f"https://app.chatbotx.io/api/v1/contacts/{identifier}"
  headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

  response = requests.delete(url, headers=headers)
  print(response.status_code)  # 204 on success
  ```

  ```javascript JavaScript theme={null}
  const identifier = 'email:user@example.com';
  const options = {
    method: 'DELETE',
    headers: { Authorization: 'Bearer YOUR_API_TOKEN' }
  };

  fetch(`https://app.chatbotx.io/api/v1/contacts/${identifier}`, options)
    .then(res => {
      if (res.status === 204) console.log('Contact deleted successfully');
    })
    .catch(err => console.error(err));
  ```
</CodeGroup>

## Response

A successful request returns **HTTP 204 No Content** with no response body.

```
HTTP/1.1 204 No Content
```