---
title: "Changes to Update an incoming phone number"
method: POST
path: "/Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}"
---

# Changes to Update an incoming phone number

`POST /Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 47 revisions.

- **2026-05-12** `2916d5e3072e`: 6 breaking, 6 info
- **2026-05-12** `5344c0c93a4c`: 1 breaking, 6 info
- **2026-03-04** `2e516ba2383f`: 12 breaking
- **2026-01-21** `250c3ae23842`: 1 breaking
- **2026-01-19** `d5fbaaddfa3e`: 23 breaking, 9 warning, 46 info
- **2026-01-15** `a10b019314cd`: 2 warning
- **2026-01-15** `07f73f74a61d`: 1 breaking, 1 info
- **2026-01-15** `518ffc8751b7`: 6 info
- **2026-01-15** `6b2611cfa74b`: 5 breaking
- **2026-01-15** `686ef84c2abc`: 5 breaking, 5 info
- **2026-01-15** `3c88f14db21e`: 7 breaking, 4 warning, 25 info

## Changes

- **2026-05-12** `2916d5e3072e`: 6 breaking, 6 info
  - added `#/components/schemas/uuid` to the `AccountSid` request property `allOf` list
  - added `#/components/schemas/uuid` to the `EmergencyAddressSid` request property `allOf` list
  - added `#/components/schemas/uuid` to the `SmsApplicationSid` request property `allOf` list
  - added `#/components/schemas/uuid` to the `VoiceApplicationSid` request property `allOf` list
  - the `account_id` response's property type changed from `string` to no type, and format from `uuid` to no format for status `200`
  - the `account_sid` response's property type changed from `string` to no type, and format from `uuid` to no format for status `200`
  - the `AccountSid` request property type was generalized from `string` to no type, and format from `uuid` to no format
  - the `EmergencyAddressSid` request property type was generalized from `string` to no type, and format from `uuid` to no format
  - the `SmsApplicationSid` request property type was generalized from `string` to no type, and format from `uuid` to no format
  - the `VoiceApplicationSid` request property type was generalized from `string` to no type, and format from `uuid` to no format
  - added `#/components/schemas/uuid` to the `account_id` response property `allOf` list for the response status `200`
  - added `#/components/schemas/uuid` to the `account_sid` response property `allOf` list for the response status `200`
- **2026-05-12** `5344c0c93a4c`: 1 breaking, 6 info
  - added 'unevaluatedProperties' constraint to the request body
  - added 'unevaluatedProperties' constraint to the response body for the status `200`
  - added 'unevaluatedProperties' constraint to the response body for the status `400`
  - added 'unevaluatedProperties' constraint to the response body for the status `401`
  - added 'unevaluatedProperties' constraint to the response body for the status `404`
  - added 'unevaluatedProperties' constraint to the response body for the status `422`
  - added 'unevaluatedProperties' constraint to the `capabilities/allOf[#/components/schemas/IncomingPhoneNumberCapabilities]/` response property for the status `200`
- **2026-03-04** `2e516ba2383f`: 12 breaking
  - response property `address_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `emergency_address_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `identity_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `sms_application_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `sms_fallback_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `sms_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `status_callback` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `trunk_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice_application_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice_caller_id_lookup` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice_fallback_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2026-01-21** `250c3ae23842`: 1 breaking
  - removed the enum value `none` of the request property `VoiceReceiveMode`
- **2026-01-19** `d5fbaaddfa3e`: 23 breaking, 9 warning, 46 info
  - the `FriendlyName` request property's minLength was increased from `0` to `1`
  - the `AccountSid` request property format changed from no format to `uuid`
  - the `EmergencyAddressSid` request property format changed from no format to `uuid`
  - the `SmsApplicationSid` request property format changed from no format to `uuid`
  - the `SmsFallbackUrl` request property format changed from no format to `uri`
  - the `SmsUrl` request property format changed from no format to `uri`
  - the `StatusCallback` request property format changed from no format to `uri`
  - the `VoiceApplicationSid` request property format changed from no format to `uuid`
  - the `VoiceFallbackUrl` request property format changed from no format to `uri`
  - the `VoiceUrl` request property format changed from no format to `uri`
  - the response property `address_sid` became nullable for the status `200`
  - the response property `emergency_address_sid` became nullable for the status `200`
  - the response property `identity_sid` became nullable for the status `200`
  - the response property `sms_application_sid` became nullable for the status `200`
  - the response property `sms_fallback_url` became nullable for the status `200`
  - the response property `sms_url` became nullable for the status `200`
  - the response property `status_callback` became nullable for the status `200`
  - the response property `trunk_sid` became nullable for the status `200`
  - the response property `voice_application_sid` became nullable for the status `200`
  - the response property `voice_caller_id_lookup` became nullable for the status `200`
  - the response property `voice_fallback_url` became nullable for the status `200`
  - the response property `voice_url` became nullable for the status `200`
  - the `emergency_status` response's property type changed from no type to `string` for status `200`
  - the `FriendlyName` request property's maxLength was set to `255`
  - removed the request property `AddressSid`
  - removed the request property `IdentitySid`
  - removed the request property `TrunkSid`
  - removed the request property `VoiceCallerIdLookup`
  - removed the optional property `capabilities/allOf[#/components/schemas/IncomingPhoneNumberCapabilities]/Fax` from the response with the `200` status
  - removed the optional property `capabilities/allOf[#/components/schemas/IncomingPhoneNumberCapabilities]/MMS` from the response with the `200` status
  - removed the optional property `capabilities/allOf[#/components/schemas/IncomingPhoneNumberCapabilities]/SMS` from the response with the `200` status
  - removed the optional property `capabilities/allOf[#/components/schemas/IncomingPhoneNumberCapabilities]/Voice` from the response with the `200` status
  - the `SmsFallbackMethod` request property default value `POST` was added
  - the `SmsMethod` request property default value `POST` was added
  - the `StatusCallbackMethod` request property default value `POST` was added
  - the `VoiceFallbackMethod` request property default value `POST` was added
  - the `VoiceMethod` request property default value `POST` was added
  - added the new `none` enum value to the request property `VoiceReceiveMode`
  - added the non-success response with the status `400`
  - added the non-success response with the status `422`
  - …38 more
- **2026-01-15** `a10b019314cd`: 2 warning
  - removed the optional property `account_id` from the response with the `200` status
  - removed the optional property `country_code` from the response with the `200` status
- **2026-01-15** `07f73f74a61d`: 1 breaking, 1 info
  - removed the media type `application/json` from the request body
  - added the media type `application/x-www-form-urlencoded` to the request body
- **2026-01-15** `518ffc8751b7`: 6 info
  - added the new optional request property `AccountSid`
  - added the new optional request property `EmergencyAddressSid`
  - added the new optional request property `IdentitySid`
  - added the new optional request property `VoiceReceiveMode`
  - added the optional property `account_id` to the response with the `200` status
  - added the optional property `country_code` to the response with the `200` status
- **2026-01-15** `6b2611cfa74b`: 5 breaking
  - the request property `SmsApplicationSid` became not nullable
  - the request property `SmsFallbackUrl` became not nullable
  - the request property `SmsUrl` became not nullable
  - the request property `TrunkSid` became not nullable
  - the request property `VoiceApplicationSid` became not nullable
- **2026-01-15** `686ef84c2abc`: 5 breaking, 5 info
  - the response property `emergency_address_sid` became nullable for the status `200`
  - the response property `sms_application_sid` became nullable for the status `200`
  - the response property `sms_fallback_url` became nullable for the status `200`
  - the response property `sms_url` became nullable for the status `200`
  - the response property `voice_application_sid` became nullable for the status `200`
  - the request property `SmsApplicationSid` became nullable
  - the request property `SmsFallbackUrl` became nullable
  - the request property `SmsUrl` became nullable
  - the request property `TrunkSid` became nullable
  - the request property `VoiceApplicationSid` became nullable
- **2026-01-15** `3c88f14db21e`: 7 breaking, 4 warning, 25 info
  - added the new path request parameter `AccountSid`
  - added the new path request parameter `Sid`
  - removed the media type `application/x-www-form-urlencoded` from the request body
  - the `address_requirements` response's property type changed from `string` to no type for status `200`
  - the `capabilities` response's property type changed from `object` to no type for status `200`
  - the `emergency_status` response's property type changed from `string` to no type for status `200`
  - the `origin` response's property type changed from `string` to no type for status `200`
  - removed the optional property `capabilities/Fax` from the response with the `200` status
  - removed the optional property `capabilities/MMS` from the response with the `200` status
  - removed the optional property `capabilities/SMS` from the response with the `200` status
  - removed the optional property `capabilities/Voice` from the response with the `200` status
  - added the media type `application/json` to the request body
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added `#/components/schemas/AddressRequirements` to the `address_requirements` response property `allOf` list for the response status `200`
  - added `#/components/schemas/EmergencyStatus` to the `emergency_status` response property `allOf` list for the response status `200`
  - added `#/components/schemas/IncomingPhoneNumberCapabilities` to the `capabilities` response property `allOf` list for the response status `200`
  - added `#/components/schemas/PhoneNumberOrigin` to the `origin` response property `allOf` list for the response status `200`
  - removed the `GET` enum value from the `sms_fallback_method` response property for the response status `200`
  - removed the `GET` enum value from the `sms_method` response property for the response status `200`
  - removed the `GET` enum value from the `status_callback_method` response property for the response status `200`
  - removed the `GET` enum value from the `voice_fallback_method` response property for the response status `200`
  - removed the `GET` enum value from the `voice_method` response property for the response status `200`
  - removed the `POST` enum value from the `sms_fallback_method` response property for the response status `200`
  - removed the `POST` enum value from the `sms_method` response property for the response status `200`
  - removed the `POST` enum value from the `status_callback_method` response property for the response status `200`
  - removed the `POST` enum value from the `voice_fallback_method` response property for the response status `200`
  - removed the `POST` enum value from the `voice_method` response property for the response status `200`
  - removed the `active` enum value from the `emergency_status` response property for the response status `200`
  - removed the `any` enum value from the `address_requirements` response property for the response status `200`
  - removed the `foreign` enum value from the `address_requirements` response property for the response status `200`
  - removed the `hosted` enum value from the `origin` response property for the response status `200`
  - removed the `inactive` enum value from the `emergency_status` response property for the response status `200`
  - removed the `local` enum value from the `address_requirements` response property for the response status `200`
  - removed the `none` enum value from the `address_requirements` response property for the response status `200`
  - removed the `signalwire` enum value from the `origin` response property for the response status `200`

---

[Operation](https://skmtc.dev/signalwire/apis/compatibility-api/docs/Accounts/:AccountSid/IncomingPhoneNumbers/:Sid/post.md) - [API](https://skmtc.dev/signalwire/apis/compatibility-api.md) - [Page](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/IncomingPhoneNumbers/:Sid/post)
