---
title: "Delete a Phone Number"
method: DELETE
path: "/v1/voice-agents/phone-number"
---

# Delete a Phone Number

`DELETE /v1/voice-agents/phone-number`

Removes a phone number from the user's account.

## Query parameters

- `phoneNumber` string, required

## Response `200`

Successful response

- DeletePhoneNumberResponse
  - `success` boolean
  - `message` string
  - `messageKey` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Phone number not found or does not belong to user
- `500` — Server Side Error

---

[API](https://skmtc.net/tryhamsa/apis/hamsa-api.md) · [All operations](https://skmtc.net/tryhamsa/apis/hamsa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryhamsa/hamsa-api/versions/ecbeb5d8dc13/schema)