> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telzino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove an SMS Number

> Take a hosted SMS number off an organization

This call needs a partner-level API key. It is refused while an agent uses the number, through a conversation channel or a Send Hosted SMS function. Take the number off those agents first, then remove it.

## Path Parameters

**organization\_id** `string` *required*

The organization's UUID

**number** `string` *required*

The E.164 number. Its leading `+` is not safe in a URL path, so send it percent-encoded (`%2B13234137301`).

```bash cURL theme={null}
curl -X DELETE "https://api.telzino.com/v1/organizations/234cd323-…/sms-numbers/%2B13234137301" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

```json 200 theme={null}
{ "data": { "phone_number": "+13234137301" } }
```

```json 409 theme={null}
{
  "error": "number_in_use",
  "error_description": "That number is in use. Take it off these agents first.",
  "in_use_by": [
    { "type": "conversation_channel", "agent_id": "9f1c…", "agent_name": "Front Desk" },
    { "type": "send_hosted_sms", "agent_id": "71f7…", "agent_name": "Sales" }
  ]
}
```

| Code | Meaning |
| - | - |
| `200` | Removed |
| `400` | The number is not valid E.164 |
| `403` | The API key is not partner-level |
| `404` | Organization not found, or the number is not on this organization |
| `409` | The number is in use (`number_in_use`). `in_use_by` lists what uses it. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.