# Phone numbers: Delete a phone number (https://docs.envocal.ai/api-reference/phone-numbers/delete-a-phone-number/)

> Requires phone_numbers:write

## DELETE `/v1/tenants/{tenantId}/phone-numbers/{id}`

**Required permission:** `phone_numbers:write`

### Parameters

| Name | In | | Type | Description |
| --- | --- | --- | --- | --- |
| `tenantId` | path | required | string | Tenant id, or `current` for the key's own tenant. Must be the key's tenant or one of its sub-tenants. |
| `id` | path | required | string | Phone number id. |

### Responses

**204**: Deleted.

**401**: Missing, invalid, revoked or expired API key.

**403**: The key lacks the required permission, or the tenant/resource is outside its reach.

**404**: Not found in this tenant.

**409**: The number is assigned to an agent; unassign it first.

**429**: Rate limit exceeded. Retry after the number of seconds in the Retry-After header.

### Example

```bash
curl -X DELETE "https://api.envocal.ai/v1/tenants/current/phone-numbers/{id}" \
  -H "Authorization: Bearer evk_eu_..."
```