---
title: "Clear caller ID name"
method: DELETE
path: "/api/relay/rest/phone_numbers/{id}/cnam"
tags: ["Caller ID Name"]
---

# Clear caller ID name

`DELETE /api/relay/rest/phone_numbers/{id}/cnam`

## Request

- Base URL: `https://{Your_Space_Name}.signalwire.com`
- URL: `https://{Your_Space_Name}.signalwire.com/api/relay/rest/phone_numbers/{id}/cnam`
- Auth: HTTP basic

Queues removal of the caller ID name from a phone number in your project. A `204` means SignalWire accepted the request; the applied name remains available as `cnam` on the phone number until the carrier confirms the removal. After confirmation, `cnam` becomes `null` and SignalWire cancels any request still `pending` or `in_review`.

SignalWire first checks whether the phone number's carrier offers caller ID name. If it does not, the operation returns `422` with an item in `errors` whose `detail` is `Caller ID name isn't available for this number.` For a supported phone number, there must be an applied name or a request awaiting a decision; otherwise the operation returns `422` because there is nothing to clear.

Returns `404` when the phone number is not in your project.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required: Universal Unique Identifier.

## Response `204`

There is no content to send for this request, but the headers may be useful.

## Other responses

- `401`: Access is unauthorized.
- `404`: The server cannot find the requested resource.
- `422`: The request failed validation. See errors for details.
- `500`: An internal server error occurred.

## Changes

> 173 revisions in range; 3 could not be searched.

- **2026-08-28** `d6ae7c53d1e2`: 2 info
  - api tag `Caller ID Name` added
  - api tag `Phone Numbers` removed
- **2026-08-27** `6a0a43b3e01e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signalwire/apis/signalwire-rest-api/changes/api/relay/rest/phone_numbers/:id/cnam/delete.md)

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) - [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/7307749294e0?raw)