---
title: "Changes to Link Number"
method: POST
path: "/v1/numbers/link"
---

# Changes to Link Number

`POST /v1/numbers/link`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 12 of 31 revisions.

- **2024-08-27** `ffca17c004e2` — 2 info
- **2024-08-14** `63991d99e2e1` — 13 breaking, 19 warning, 3 info
- **2024-04-15** `47ab17602d64` — 1 breaking, 5 info
- **2024-03-20** `3dbe7b5c464d` — 1 info
- **2024-03-18** `500a519452b0` — 1 warning, 5 info
- **2024-01-03** `5086814bf16a` — 1 breaking, 4 info
- **2023-12-12** `1111aff32f0a` — 8 warning, 1 info
- **2023-12-08** `5d83963279c9` — 2 info
- **2023-12-03** `17fa3c507aa2` — 1 warning, 1 info
- **2023-12-01** `e5b6e245d522` — 1 info
- **2023-11-30** `708f4c6fa873` — 2 info
- **2023-11-25** `97850bfccb2c` — 1 info

## Changes

- **2024-08-27** `ffca17c004e2` — 2 info
  - added the new optional request property `inbound_agent/anyOf[subschema #1: AgentParams]/idle_time_seconds`
  - added the optional property `inbound_agent/anyOf[subschema #1: Agent]/idle_time_seconds` to the response with the `200` status
- **2024-08-14** `63991d99e2e1` — 13 breaking, 19 warning, 3 info
  - the response property `inbound_agent` became optional for the status `200`
  - response property `example_context` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `inbound_agent` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `telephony_account_connection` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `inbound_agent/actions` from the response with the `200` status
  - removed the required property `inbound_agent/id` from the response with the `200` status
  - removed the required property `inbound_agent/prompt` from the response with the `200` status
  - removed the required property `inbound_agent/user_id` from the response with the `200` status
  - removed the required property `inbound_agent/voice` from the response with the `200` status
  - removed the required property `telephony_account_connection/credentials` from the response with the `200` status
  - removed the required property `telephony_account_connection/id` from the response with the `200` status
  - removed the required property `telephony_account_connection/type` from the response with the `200` status
  - removed the required property `telephony_account_connection/user_id` from the response with the `200` status
  - removed the optional property `inbound_agent/ask_if_human_present_on_idle` from the response with the `200` status
  - removed the optional property `inbound_agent/context_endpoint` from the response with the `200` status
  - removed the optional property `inbound_agent/conversation_speed` from the response with the `200` status
  - removed the optional property `inbound_agent/endpointing_sensitivity` from the response with the `200` status
  - removed the optional property `inbound_agent/initial_message` from the response with the `200` status
  - removed the optional property `inbound_agent/initial_message_delay` from the response with the `200` status
  - removed the optional property `inbound_agent/interrupt_sensitivity` from the response with the `200` status
  - removed the optional property `inbound_agent/ivr_navigation_mode` from the response with the `200` status
  - removed the optional property `inbound_agent/language` from the response with the `200` status
  - removed the optional property `inbound_agent/llm_temperature` from the response with the `200` status
  - removed the optional property `inbound_agent/name` from the response with the `200` status
  - removed the optional property `inbound_agent/noise_suppression` from the response with the `200` status
  - removed the optional property `inbound_agent/openai_account_connection` from the response with the `200` status
  - removed the optional property `inbound_agent/openai_model_name_override` from the response with the `200` status
  - removed the optional property `inbound_agent/run_do_not_call_detection` from the response with the `200` status
  - removed the optional property `inbound_agent/vector_database` from the response with the `200` status
  - removed the optional property `inbound_agent/webhook` from the response with the `200` status
  - removed the optional property `telephony_account_connection/account_supports_any_caller_id` from the response with the `200` status
  - removed the optional property `telephony_account_connection/steering_pool` from the response with the `200` status
  - added the new optional request property `inbound_agent`
  - added `#/components/schemas/Agent, subschema #2` to the `inbound_agent` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/TwilioAccountConnection, subschema #2` to the `telephony_account_connection` response property `anyOf` list for the response status `200`
- **2024-04-15** `47ab17602d64` — 1 breaking, 5 info
  - added `#/components/schemas/ExternalAction` to the `inbound_agent/actions/items/` response property `oneOf` list for the response status `200`
  - added the optional property `inbound_agent/name` to the response with the `200` status
  - added the optional property `inbound_agent/voice/oneOf[subschema #2: RimeVoice]/model_id` to the response with the `200` status
  - added the optional property `telephony_account_connection/account_supports_any_caller_id` to the response with the `200` status
  - added the optional property `telephony_account_connection/steering_pool` to the response with the `200` status
  - added `action_external` discriminator mapping keys to the `inbound_agent/actions/items/` response property for the response status `200`
- **2024-03-20** `3dbe7b5c464d` — 1 info
  - added the optional property `inbound_agent/llm_temperature` to the response with the `200` status
- **2024-03-18** `500a519452b0` — 1 warning, 5 info
  - added the new `event_phone_call_did_not_connect` enum value to the `inbound_agent/webhook/subscriptions/items/` response property for the response status `200`
  - added the optional property `inbound_agent/voice/oneOf[subschema #3: ElevenLabsVoice]/experimental_input_streaming` to the response with the `200` status
  - added the optional property `inbound_agent/voice/oneOf[subschema #4: PlayHtVoice]/experimental_remove_silence` to the response with the `200` status
  - added the optional property `inbound_agent/voice/oneOf[subschema #4: PlayHtVoice]/text_guidance` to the response with the `200` status
  - added the optional property `inbound_agent/voice/oneOf[subschema #4: PlayHtVoice]/top_p` to the response with the `200` status
  - added the optional property `inbound_agent/voice/oneOf[subschema #4: PlayHtVoice]/voice_guidance` to the response with the `200` status
- **2024-01-03** `5086814bf16a` — 1 breaking, 4 info
  - added `#/components/schemas/AddToConferenceAction, #/components/schemas/SetHoldAction` to the `inbound_agent/actions/items/` response property `oneOf` list for the response status `200`
  - added the optional property `inbound_agent/actions/items/oneOf[subschema #1: TransferCallAction]/action_trigger` to the response with the `200` status
  - added the optional property `inbound_agent/actions/items/oneOf[subschema #2: EndConversationAction]/action_trigger` to the response with the `200` status
  - added the optional property `inbound_agent/actions/items/oneOf[subschema #3: DTMFAction]/action_trigger` to the response with the `200` status
  - added `action_add_to_conference, action_set_hold` discriminator mapping keys to the `inbound_agent/actions/items/` response property for the response status `200`
- **2023-12-12** `1111aff32f0a` — 8 warning, 1 info
  - added the new `fr` enum value to the `inbound_agent/language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `hi` enum value to the `inbound_agent/language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `id` enum value to the `inbound_agent/language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `it` enum value to the `inbound_agent/language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `ja` enum value to the `inbound_agent/language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `ko` enum value to the `inbound_agent/language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `nl` enum value to the `inbound_agent/language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `pt` enum value to the `inbound_agent/language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the optional property `inbound_agent/ask_if_human_present_on_idle` to the response with the `200` status
- **2023-12-08** `5d83963279c9` — 2 info
  - added the optional property `inbound_agent/voice/oneOf[subschema #4: PlayHtVoice]/quality` to the response with the `200` status
  - added the optional property `inbound_agent/voice/oneOf[subschema #4: PlayHtVoice]/temperature` to the response with the `200` status
- **2023-12-03** `17fa3c507aa2` — 1 warning, 1 info
  - added the new `sensitive` enum value to the `inbound_agent/endpointing_sensitivity` response property for the response status `200`
  - added the optional property `inbound_agent/run_do_not_call_detection` to the response with the `200` status
- **2023-12-01** `e5b6e245d522` — 1 info
  - the `interrupt_sensitivity` response's property default value changed from `high` to `low` for the status `200`
- **2023-11-30** `708f4c6fa873` — 2 info
  - added the optional property `inbound_agent/openai_account_connection` to the response with the `200` status
  - added the optional property `inbound_agent/openai_model_name_override` to the response with the `200` status
- **2023-11-25** `97850bfccb2c` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/docs/v1/numbers/link/post.md) · [API](https://skmtc.dev/vocodedev/apis/vocode-hosted-api.md) · [Page](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/numbers/link/post)
