---
title: "Release a phone number"
method: DELETE
path: "/v1/phone-number/{phoneNumberId}"
tags: ["Phone Number"]
---

# Release a phone number

`DELETE /v1/phone-number/{phoneNumberId}`

## Request

- Base URL: `https://api.roark.ai`
- URL: `https://api.roark.ai/v1/phone-number/{phoneNumberId}`
- Auth: HTTP bearer

Gives the number back to the carrier. This cannot be undone: rent stops today and nothing is refunded.

## Path parameters

- `phoneNumberId` string, uuid, required: Phone number ID

## Response `200`

The number was released

- object
  - `data` ReleasePhoneNumberResponse, required: Confirmation that a phone number was released
    - `id` string, uuid, required: Phone number ID
    - `released` true, required: Always true; the number is gone and rent has stopped

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

> 188 revisions in range; 1 not diffed.

- **2026-10-26** `0fb1c3b1940a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/phone-number/:phoneNumberId/delete.md)

---

[API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roarkhq/apis/roark-analytics-api/revisions/efc3377249d1?raw)