> ## 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.

# Remove from DNC List

> Remove a phone number from your organization's Do Not Call (DNC) list.

## Overview

Permanently remove a phone number from your organization's Do Not Call list. Once removed, the number can be called again in future campaigns. You can only delete DNC entries that belong to your organization.

## Prerequisites

* Bearer token for authenticated workspace access
* Valid DNC record ID that belongs to your organization

## Request

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

<ParamField path="id" type="string" required>
  Unique identifier of the DNC record to delete. This is the `_id` field from the DNC list response.
</ParamField>

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

## Response

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

<ResponseField name="message" type="string" required>
  Success message confirming the DNC record was deleted.
</ResponseField>

<ResponseField name="status" type="boolean" required>
  Indicates whether the operation was successful.
</ResponseField>

<ResponseField name="code" type="integer" required>
  HTTP status code (200 for success).
</ResponseField>

## Error Handling

* **400 Bad Request** – Missing or invalid DNC ID parameter.
* **403 Forbidden** – You are not authorized to delete this DNC record (it belongs to a different organization).
* **404 Not Found** – DNC record not found with the provided ID.
* **500 Internal Server Error** – Server error while processing the deletion.

<Warning>
  This action is permanent. Once a DNC record is deleted, the phone number can be called again in future campaigns. Make sure you have the correct DNC record ID before deleting.
</Warning>


## OpenAPI

````yaml DELETE /api/dnc/delete/{id}
openapi: 3.1.0
info:
  title: Weya AI Public API
  description: >-
    Public API documentation for Weya AI platform - Call Management and DNC (Do
    Not Call) APIs
  version: 1.0.0
servers:
  - url: >-
      https://nexusdev-wjs-api-dev.mangoforest-291de162.swedencentral.azurecontainerapps.io
    description: Development server
security:
  - bearerAuth: []
  - apiKeyAuth: []
paths:
  /api/dnc/delete/{id}:
    delete:
      tags:
        - DNC (Do Not Call)
      summary: Remove from DNC list
      description: Remove a phone number from your organization's DNC list
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          description: DNC record deleted successfully
        '400':
          description: DNC ID is required
        '403':
          description: Not authorized to delete this DNC record
        '404':
          description: DNC record not found
        '500':
          description: Internal Server Error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer token authentication for workspace access
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key used for programmatic calling integrations. Find it under
        Settings → API access in your workspace.

````