---
title: "Remove SMS number"
method: DELETE
path: "/sms/numbers/{numberId}"
tags: ["SMS"]
---

# Remove SMS number

`DELETE /sms/numbers/{numberId}`

Release a toll-free number and free its workspace slot. Requires companies:manage. Steps explicitly pinned to this number do not switch to another number. This action cannot reclaim the number after release.

## Path parameters

- `numberId` string, required

## Response `200`

SMS number released

- object
  - `success` boolean, required
  - `number` object, required
    - `id` string, required
    - `status` 'released', required
  - `message` string, required

## Other responses

- `400` — The number was already released
- `401` — Missing or invalid API key
- `403` — Missing companies:manage or company edit permission
- `404` — Company or SMS number not found
- `409` — A number purchase or conflicting operation is in progress
- `500` — Failed to release the number
- `503` — Carrier release temporarily failed

## Changes

- **2026-09-08** `f1d8cfd9faaf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/sms/numbers/:numberId/delete.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sequenzy/apis/sequenzy-api/revisions/e93563b0d37e?raw)