---
title: "Changes to Update Phone Number"
method: PATCH
path: "/v1/convai/phone-numbers/{phone_number_id}"
---

# Changes to Update Phone Number

`PATCH /v1/convai/phone-numbers/{phone_number_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 108 revisions.

- **2026-07-13** `009bd651509a`: 3 info
- **2026-06-08** `37fac3c5a2d7`: 1 breaking, 14 info
- **2026-04-03** `deb5e58ddddf`: 7 info
- **2026-02-08** `5b595807512c`: 17 info
- **2025-05-16** `503db4198a44`: 7 breaking, 2 warning, 4 info
- **2024-12-02** `d04ae85f47ff`: 1 info

## Changes

- **2026-07-13** `009bd651509a`: 3 info
  - added the new optional request property `outbound_trunk_config/anyOf[subschema #1: OutboundSIPTrunkConfigRequestModel]/enabled_codecs`
  - added the optional property `oneOf[subschema #3: GetPhoneNumberSIPTrunkResponseModel]/outbound_trunk/anyOf[subschema #1: GetPhoneNumberOutboundSIPTrunkConfigResponseModel]/enabled_codecs` to the response with the `200` status
  - added the optional property `oneOf[subschema #3: GetPhoneNumberSIPTrunkResponseModel]/provider_config/anyOf[subschema #1: GetPhoneNumberOutboundSIPTrunkConfigResponseModel]/enabled_codecs` to the response with the `200` status
- **2026-06-08** `37fac3c5a2d7`: 1 breaking, 14 info
  - added `#/components/schemas/GetPhoneNumberExotelResponseModel` to the response body `oneOf` list for the response status `200`
  - added the new optional request property `branch_id`
  - added the new optional request property `environment`
  - added the new optional request property `inbound_trunk_config/anyOf[subschema #1: InboundSIPTrunkConfigRequestModel]/attributes_to_headers`
  - added the new optional request property `outbound_trunk_config/anyOf[subschema #1: OutboundSIPTrunkConfigRequestModel]/attributes_to_headers`
  - added the new optional request property `store_sip_messages`
  - added `exotel` mapping keys to the response discriminator for the response status `200`
  - added the optional property `oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/branch_id` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/environment` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/branch_id` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/environment` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/inbound_trunk/anyOf[subschema #1: GetPhoneNumberInboundSIPTrunkConfigResponseModel]/attributes_to_headers` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/outbound_trunk/anyOf[subschema #1: GetPhoneNumberOutboundSIPTrunkConfigResponseModel]/attributes_to_headers` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/provider_config/anyOf[subschema #1: GetPhoneNumberOutboundSIPTrunkConfigResponseModel]/attributes_to_headers` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/store_sip_messages` to the response with the `200` status
- **2026-04-03** `deb5e58ddddf`: 7 info
  - the `` request property default value `standard` was added
  - the `livekit_stack` response's property default value `standard` was added for the status `200`
  - the `media_encryption` response's property default value `allowed` was added for the status `200`
  - the `media_encryption` response's property default value `allowed` was added for the status `200`
  - the `media_encryption` response's property default value `allowed` was added for the status `200`
  - the `transport` response's property default value `auto` was added for the status `200`
  - the `transport` response's property default value `auto` was added for the status `200`
- **2026-02-08** `5b595807512c`: 17 info
  - api operation id `Update_phone_number_v1_convai_phone_numbers__phone_number_id__patch` removed and replaced with `update_phone_number_route`
  - api tag `Agents Platform` added
  - api tag `Conversational AI` removed
  - added the new optional request property `inbound_trunk_config`
  - added the new optional request property `label`
  - added the new optional request property `livekit_stack`
  - added the new optional request property `outbound_trunk_config`
  - added the optional property `oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/supports_inbound` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/supports_outbound` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/inbound_trunk` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/outbound_trunk` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/supports_inbound` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/supports_outbound` to the response with the `200` status
  - added `#/components/schemas/GetPhoneNumberOutboundSIPTrunkConfigResponseModel` to the `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/provider_config` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/SIPTrunkConfigResponseModel` from the `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/provider_config` response property `anyOf` list for the response status `200`
  - response property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/provider_config` deprecated
  - added the required property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/livekit_stack` to the response with the `200` status
- **2025-05-16** `503db4198a44`: 7 breaking, 2 warning, 4 info
  - the request's body type changed from no type to `object`
  - added `#/components/schemas/GetPhoneNumberTwilioResponseModel, #/components/schemas/GetPhoneNumberSIPTrunkResponseModel` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `label` from the response with the `200` status
  - removed the required property `phone_number` from the response with the `200` status
  - removed the required property `phone_number_id` from the response with the `200` status
  - removed the required property `provider` from the response with the `200` status
  - removed `#/components/schemas/UpdatePhoneNumberRequest` from the request body `allOf` list
  - removed the optional property `assigned_agent` from the response with the `200` status
  - added the new optional request property `agent_id`
  - `header` request parameter `xi-api-key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `xi-api-key`, the type was generalized from `string` to no type
  - added response discriminator for the response status `200`
- **2024-12-02** `d04ae85f47ff`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/docs/v1/convai/phone-numbers/:phone_number_id/patch.md) - [API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [Page](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/phone-numbers/:phone_number_id/patch)