> Tychron Atlas API & Provisioning Reference — chapter 21 of 35 as Markdown. Web version: https://docs.tychron.com/api-reference/number-management/
> Source: https://docs.tychron.com/api-reference/ · Updated 2026-08-12 · Generated from the Atlas OpenAPI spec (https://api.atlas.tychron.online/api/v1/openapi is the live contract; this file is a dated snapshot of it).
> Source revision: atlas_api_reference_2026-08-12.md · sha256 482ebd3b014af053 · sanitize gate v1 clean · reconciled with OpenAPI 2026.8.25-p01 (spec sha256 cc049ef38c71cd6e) on 2026-09-05 · content last modified 2026-09-09 · newer definition under review since 2026-09-09 (not yet reconciled)
> Scope: the Atlas platform API only. The SMS, MMS, CNAM, LRN and MCL services are separate APIs with their own specifications: https://docs.tychron.com/openapi/
> Machine index: https://docs.tychron.com/llms.txt

# Number Management

## Toggling MMS on an existing number

MMS is available for any and all sms enabled numbers, as long as the account allows it, it can be toggled at anytime.

Toggling MMS can be done via the Numbers update route:

__Structure__

```http
PATCH /api/v1/numbers/:number

Accept: application/json
Content-Type: application/json
Authorization: Bearer API_KEY_HTTP_KEY
```

```javascript
{
  "type": "number",
  "data": {
    "mms_enabled": boolean
  }
}
```

__Example 1__

To enable MMS on an existing number:

```http
PATCH /api/v1/numbers/12003004000

Accept: application/json
Content-Type: application/json
Authorization: Bearer API_KEY_HTTP_KEY
```

```json
{
  "type": "number",
  "data": {
    "mms_enabled": true
  }
}
```

__Example 2__

To disable MMS on an existing number:

```http
PATCH /api/v1/numbers/12003004000

Accept: application/json
Content-Type: application/json
Authorization: Bearer API_KEY_HTTP_KEY
```

```json
{
  "type": "number",
  "data": {
    "mms_enabled": false
  }
}
```

---

Previous chapter: https://docs.tychron.com/api-reference/dids.md  
Next chapter: https://docs.tychron.com/api-reference/did-destinations.md  
Complete reference in one file: https://docs.tychron.com/llms-full.txt