---
title: "Changes to Get Agent"
method: GET
path: "/v1/agents"
---

# Changes to Get Agent

`GET /v1/agents`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 21 of 31 revisions.

- **2024-08-27** `ffca17c004e2` — 1 info
- **2024-08-14** `63991d99e2e1` — 46 breaking, 2 warning, 44 info
- **2024-04-15** `47ab17602d64` — 1 breaking, 3 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` — 3 info
- **2023-10-25** `712314def757` — 1 info
- **2023-10-13** `9feade6bcba8` — 2 breaking, 1 info
- **2023-10-05** `f4d951d6fa94` — 1 warning, 1 info
- **2023-09-26** `eb14a21c478e` — 1 breaking, 2 info
- **2023-09-19** `bcd75d816789` — 1 info
- **2023-09-07** `c9ae97ec337f` — 2 info
- **2023-09-06** `ec1d8c780c18` — 1 breaking, 1 warning, 3 info
- **2023-08-27** `b1390b72fe85` — 1 info
- **2023-08-26** `50986fe3a37f` — 1 breaking, 5 info

## Changes

- **2024-08-27** `ffca17c004e2` — 1 info
  - added the optional property `idle_time_seconds` to the response with the `200` status
- **2024-08-14** `63991d99e2e1` — 46 breaking, 2 warning, 44 info
  - response property `context_endpoint` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `initial_message` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `openai_model_name_override` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `prompt/collect_fields` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `prompt/context_endpoint` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #2: RimeVoice]/speed_alpha` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #3: ElevenLabsVoice]/api_key` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #3: ElevenLabsVoice]/model_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #3: ElevenLabsVoice]/optimize_streaming_latency` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #3: ElevenLabsVoice]/similarity_boost` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #3: ElevenLabsVoice]/stability` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #4: PlayHtVoice]/api_key` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #4: PlayHtVoice]/api_user_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #4: PlayHtVoice]/quality` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #4: PlayHtVoice]/speed` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #4: PlayHtVoice]/temperature` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #4: PlayHtVoice]/text_guidance` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #4: PlayHtVoice]/top_p` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `voice/oneOf[subschema #4: PlayHtVoice]/voice_guidance` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `actions/items/oneOf[subschema #1: TransferCallAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `actions/items/oneOf[subschema #2: EndConversationAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `actions/items/oneOf[subschema #4: AddToConferenceAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `actions/items/oneOf[subschema #5: SetHoldAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/VocodeVoice` to the `voice` response property `oneOf` list for the response status `200`
  - the `openai_account_connection` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `prompt/prompt_template` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `vector_database` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `webhook` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `openai_account_connection/credentials` from the response with the `200` status
  - removed the required property `openai_account_connection/id` from the response with the `200` status
  - removed the required property `openai_account_connection/type` from the response with the `200` status
  - removed the required property `openai_account_connection/user_id` from the response with the `200` status
  - removed the required property `prompt/prompt_template/id` from the response with the `200` status
  - removed the required property `prompt/prompt_template/required_context_keys` from the response with the `200` status
  - removed the required property `prompt/prompt_template/user_id` from the response with the `200` status
  - removed the required property `vector_database/api_environment` from the response with the `200` status
  - removed the required property `vector_database/api_key` from the response with the `200` status
  - removed the required property `vector_database/id` from the response with the `200` status
  - removed the required property `vector_database/index` from the response with the `200` status
  - …52 more
- **2024-04-15** `47ab17602d64` — 1 breaking, 3 info
  - added `#/components/schemas/ExternalAction` to the `actions/items/` response property `oneOf` list for the response status `200`
  - added the optional property `name` to the response with the `200` status
  - added the optional property `voice/oneOf[subschema #2: RimeVoice]/model_id` to the response with the `200` status
  - added `action_external` discriminator mapping keys to the `actions/items/` response property for the response status `200`
- **2024-03-20** `3dbe7b5c464d` — 1 info
  - added the optional property `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 `webhook/subscriptions/items/` response property for the response status `200`
  - added the optional property `voice/oneOf[subschema #3: ElevenLabsVoice]/experimental_input_streaming` to the response with the `200` status
  - added the optional property `voice/oneOf[subschema #4: PlayHtVoice]/experimental_remove_silence` to the response with the `200` status
  - added the optional property `voice/oneOf[subschema #4: PlayHtVoice]/text_guidance` to the response with the `200` status
  - added the optional property `voice/oneOf[subschema #4: PlayHtVoice]/top_p` to the response with the `200` status
  - added the optional property `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 `actions/items/` response property `oneOf` list for the response status `200`
  - added the optional property `actions/items/oneOf[subschema #1: TransferCallAction]/action_trigger` to the response with the `200` status
  - added the optional property `actions/items/oneOf[subschema #2: EndConversationAction]/action_trigger` to the response with the `200` status
  - added the optional property `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 `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 `language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `hi` enum value to the `language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `id` enum value to the `language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `it` enum value to the `language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `ja` enum value to the `language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `ko` enum value to the `language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `nl` enum value to the `language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the new `pt` enum value to the `language/allOf[subschema #1: Language]/` response property for the response status `200`
  - added the optional property `ask_if_human_present_on_idle` to the response with the `200` status
- **2023-12-08** `5d83963279c9` — 2 info
  - added the optional property `voice/oneOf[subschema #4: PlayHtVoice]/quality` to the response with the `200` status
  - added the optional property `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 `endpointing_sensitivity` response property for the response status `200`
  - added the optional property `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 `openai_account_connection` to the response with the `200` status
  - added the optional property `openai_model_name_override` to the response with the `200` status
- **2023-11-25** `97850bfccb2c` — 3 info
  - added the optional property `initial_message_delay` to the response with the `200` status
  - added the optional property `voice/oneOf[subschema #3: ElevenLabsVoice]/model_id` to the response with the `200` status
  - added the optional property `voice/oneOf[subschema #3: ElevenLabsVoice]/optimize_streaming_latency` to the response with the `200` status
- **2023-10-25** `712314def757` — 1 info
  - added the optional property `voice/oneOf[subschema #4: PlayHtVoice]/speed` to the response with the `200` status
- **2023-10-13** `9feade6bcba8` — 2 breaking, 1 info
  - the response property `voice/oneOf[subschema #4: PlayHtVoice]/api_key` became optional for the status `200`
  - the response property `voice/oneOf[subschema #4: PlayHtVoice]/api_user_id` became optional for the status `200`
  - added the optional property `voice/oneOf[subschema #4: PlayHtVoice]/version` to the response with the `200` status
- **2023-10-05** `f4d951d6fa94` — 1 warning, 1 info
  - added the new `event_human_detection` enum value to the `webhook/subscriptions/items/` response property for the response status `200`
  - removed the `event_machine_detection` enum value from the `webhook/subscriptions/items/` response property for the response status `200`
- **2023-09-26** `eb14a21c478e` — 1 breaking, 2 info
  - the response property `prompt/content` became optional for the status `200`
  - added the optional property `prompt/prompt_template` to the response with the `200` status
  - the `content` response's property default value `` was added for the status `200`
- **2023-09-19** `bcd75d816789` — 1 info
  - added the optional property `conversation_speed` to the response with the `200` status
- **2023-09-07** `c9ae97ec337f` — 2 info
  - added the optional property `ivr_navigation_mode` to the response with the `200` status
  - added the optional property `voice/oneOf[subschema #2: RimeVoice]/speed_alpha` to the response with the `200` status
- **2023-09-06** `ec1d8c780c18` — 1 breaking, 1 warning, 3 info
  - the response property `voice/oneOf[subschema #3: ElevenLabsVoice]/api_key` became optional for the status `200`
  - added the new `event_machine_detection` enum value to the `webhook/subscriptions/items/` response property for the response status `200`
  - added the optional property `endpointing_sensitivity` to the response with the `200` status
  - the `noise_suppression` response's property default value changed from `true` to `false` for the status `200`
  - removed the `field_type_address` enum value from the `prompt/collect_fields/items/field_type` response property for the response status `200`
- **2023-08-27** `b1390b72fe85` — 1 info
  - added the optional property `noise_suppression` to the response with the `200` status
- **2023-08-26** `50986fe3a37f` — 1 breaking, 5 info
  - the `prompt` response's property type/format changed from `string`/`` to `object`/`` for status `200`
  - added the optional property `prompt/collect_fields` to the response with the `200` status
  - added the optional property `prompt/context_endpoint` to the response with the `200` status
  - added the required property `prompt/content` to the response with the `200` status
  - added the required property `prompt/id` to the response with the `200` status
  - added the required property `prompt/user_id` to the response with the `200` status

---

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