> ## 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 a Contact Custom Field via the ChatbotX API

> Use DELETE /api/v1/custom-fields/{id} to permanently remove a custom field from your ChatbotX workspace. All stored contact values are also deleted.

Use this endpoint to permanently remove a custom field from your workspace. Once deleted, any values previously stored under this field on contacts will also be removed. Make sure you no longer need the field or its data before proceeding, as this action is irreversible.

<Info>
  **DELETE** `/api/v1/custom-fields/{id}`
</Info>

## Path Parameters

<ParamField path="id" type="string" required>
  The numeric ID of the custom field to delete. Must match the pattern `\d+`.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --request DELETE \
    --url https://app.chatbotx.io/api/v1/custom-fields/103 \
    --header 'Authorization: Bearer <token>'
  ```

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

  url = "https://app.chatbotx.io/api/v1/custom-fields/103"

  headers = {"Authorization": "Bearer <token>"}

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

  ```javascript JavaScript theme={null}
  const options = {
    method: 'DELETE',
    headers: { Authorization: 'Bearer <token>' }
  };

  fetch('https://app.chatbotx.io/api/v1/custom-fields/103', options)
    .then(res => {
      if (res.status === 204) console.log('Custom field deleted successfully.');
    })
    .catch(err => console.error(err));
  ```
</CodeGroup>

## Response

Returns `204 No Content` on success. No response body is returned.

<Warning>
  Deleting a custom field is permanent and cannot be undone. All contact data associated with this field will also be removed.
</Warning>