---
title: "Changes to Create Agent"
method: POST
path: "/v1/agents/create"
---

# Changes to Create Agent

`POST /v1/agents/create`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 21 of 31 revisions.

- **2024-08-27** `ffca17c004e2` — 2 info
- **2024-08-14** `63991d99e2e1` — 77 breaking, 2 warning, 85 info
- **2024-04-15** `47ab17602d64` — 1 breaking, 6 info
- **2024-03-20** `3dbe7b5c464d` — 2 info
- **2024-03-18** `500a519452b0` — 1 warning, 11 info
- **2024-01-03** `5086814bf16a` — 1 breaking, 8 info
- **2023-12-12** `1111aff32f0a` — 8 warning, 10 info
- **2023-12-08** `5d83963279c9` — 4 info
- **2023-12-03** `17fa3c507aa2` — 1 warning, 3 info
- **2023-12-01** `e5b6e245d522` — 2 info
- **2023-11-30** `708f4c6fa873` — 4 info
- **2023-11-25** `97850bfccb2c` — 6 info
- **2023-10-25** `712314def757` — 2 info
- **2023-10-13** `9feade6bcba8` — 2 breaking, 4 info
- **2023-10-05** `f4d951d6fa94` — 1 breaking, 1 warning, 2 info
- **2023-09-26** `eb14a21c478e` — 1 breaking, 5 info
- **2023-09-19** `bcd75d816789` — 2 info
- **2023-09-07** `c9ae97ec337f` — 4 info
- **2023-09-06** `ec1d8c780c18` — 2 breaking, 1 warning, 7 info
- **2023-08-27** `b1390b72fe85` — 2 info
- **2023-08-26** `50986fe3a37f` — 2 breaking, 6 info

## Changes

- **2024-08-27** `ffca17c004e2` — 2 info
  - added the new optional request property `idle_time_seconds`
  - added the optional property `idle_time_seconds` to the response with the `200` status
- **2024-08-14** `63991d99e2e1` — 77 breaking, 2 warning, 85 info
  - added `#/components/schemas/FunctionCallActionTrigger` to the `actions/items/anyOf[subschema #2]/oneOf[subschema #3: DTMFActionParams]/action_trigger` request property `allOf` list
  - added `#/components/schemas/FunctionCallActionTrigger` to the `actions/items/anyOf[subschema #2]/oneOf[subschema #6: ExternalActionParams]/action_trigger` request property `allOf` list
  - the `processing_mode` request property const value `muted` was added
  - the `type` request property const value `account_connection_openai` was added
  - the `type` request property const value `action_add_to_conference` was added
  - the `type` request property const value `action_dtmf` was added
  - the `type` request property const value `action_end_conversation` was added
  - the `type` request property const value `action_external` was added
  - the `type` request property const value `action_set_hold` was added
  - the `type` request property const value `action_transfer_call` was added
  - the `type` request property const value `action_trigger_function_call` was added
  - the `type` request property const value `action_trigger_function_call` was added
  - the `type` request property const value `action_trigger_function_call` was added
  - the `type` request property const value `action_trigger_function_call` was added
  - the `type` request property const value `vector_database_pinecone` was added
  - the `type` request property const value `voice_azure` was added
  - the `type` request property const value `voice_eleven_labs` was added
  - the `type` request property const value `voice_play_ht` was added
  - the `type` request property const value `voice_rime` was added
  - removed the enum value `draft` of the request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/quality`
  - removed the enum value `faster` of the request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/quality`
  - removed the enum value `high` of the request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/quality`
  - removed the enum value `low` of the request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/quality`
  - removed the enum value `medium` of the request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/quality`
  - removed the enum value `premium` of the request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/quality`
  - removed `#/components/schemas/FunctionCallActionTrigger, #/components/schemas/PhraseBasedActionTrigger` from the `actions/items/anyOf[subschema #2]/oneOf[subschema #3: DTMFActionParams]/action_trigger` request property `oneOf` list
  - removed `#/components/schemas/FunctionCallActionTrigger, #/components/schemas/PhraseBasedActionTrigger` from the `actions/items/anyOf[subschema #2]/oneOf[subschema #6: ExternalActionParams]/action_trigger` request property `oneOf` list
  - removed `#/components/schemas/PhraseBasedActionTrigger` from the `actions/items/anyOf[subschema #2]/oneOf[subschema #1: TransferCallActionParams]/action_trigger` request property `oneOf` list
  - removed `#/components/schemas/PhraseBasedActionTrigger` from the `actions/items/anyOf[subschema #2]/oneOf[subschema #2: EndConversationActionParams]/action_trigger` request property `oneOf` list
  - removed `#/components/schemas/PhraseBasedActionTrigger` from the `actions/items/anyOf[subschema #2]/oneOf[subschema #4: AddToConferenceActionParams]/action_trigger` request property `oneOf` list
  - removed `#/components/schemas/PhraseBasedActionTrigger` from the `actions/items/anyOf[subschema #2]/oneOf[subschema #5: SetHoldActionParams]/action_trigger` request property `oneOf` list
  - 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`
  - …124 more
- **2024-04-15** `47ab17602d64` — 1 breaking, 6 info
  - added `#/components/schemas/ExternalAction` to the `actions/items/` response property `oneOf` list for the response status `200`
  - added the new optional request property `name`
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #2: RimeVoiceParams]/model_id`
  - added `#/components/schemas/ExternalActionParams` to the `actions/items/anyOf[subschema #2]/` request property `oneOf` list
  - 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` — 2 info
  - added the new optional request property `llm_temperature`
  - added the optional property `llm_temperature` to the response with the `200` status
- **2024-03-18** `500a519452b0` — 1 warning, 11 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 new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #3: ElevenLabsVoiceParams]/experimental_input_streaming`
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/experimental_remove_silence`
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/text_guidance`
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/top_p`
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/voice_guidance`
  - added the new `event_phone_call_did_not_connect` enum value to the request property `webhook/anyOf[subschema #2: WebhookParams]/subscriptions/items/`
  - 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, 8 info
  - added `#/components/schemas/AddToConferenceAction, #/components/schemas/SetHoldAction` to the `actions/items/` response property `oneOf` list for the response status `200`
  - added the new optional request property `actions/items/anyOf[subschema #2]/oneOf[subschema #1: TransferCallActionParams]/action_trigger`
  - added the new optional request property `actions/items/anyOf[subschema #2]/oneOf[subschema #2: EndConversationActionParams]/action_trigger`
  - added the new optional request property `actions/items/anyOf[subschema #2]/oneOf[subschema #3: DTMFActionParams]/action_trigger`
  - added `#/components/schemas/AddToConferenceActionParams, #/components/schemas/SetHoldActionParams` to the `actions/items/anyOf[subschema #2]/` request property `oneOf` list
  - 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, 10 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 new optional request property `ask_if_human_present_on_idle`
  - added the new `fr` enum value to the request property `language/allOf[subschema #1: Language]/`
  - added the new `hi` enum value to the request property `language/allOf[subschema #1: Language]/`
  - added the new `id` enum value to the request property `language/allOf[subschema #1: Language]/`
  - added the new `it` enum value to the request property `language/allOf[subschema #1: Language]/`
  - added the new `ja` enum value to the request property `language/allOf[subschema #1: Language]/`
  - added the new `ko` enum value to the request property `language/allOf[subschema #1: Language]/`
  - added the new `nl` enum value to the request property `language/allOf[subschema #1: Language]/`
  - added the new `pt` enum value to the request property `language/allOf[subschema #1: Language]/`
  - added the optional property `ask_if_human_present_on_idle` to the response with the `200` status
- **2023-12-08** `5d83963279c9` — 4 info
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/quality`
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/temperature`
  - 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, 3 info
  - added the new `sensitive` enum value to the `endpointing_sensitivity` response property for the response status `200`
  - added the new optional request property `run_do_not_call_detection`
  - added the new `sensitive` enum value to the request property `endpointing_sensitivity`
  - added the optional property `run_do_not_call_detection` to the response with the `200` status
- **2023-12-01** `e5b6e245d522` — 2 info
  - the `interrupt_sensitivity` request property default value changed from `high` to `low`
  - the `interrupt_sensitivity` response's property default value changed from `high` to `low` for the status `200`
- **2023-11-30** `708f4c6fa873` — 4 info
  - added the new optional request property `openai_account_connection`
  - added the new optional request property `openai_model_name_override`
  - 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` — 6 info
  - added the new optional request property `initial_message_delay`
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #3: ElevenLabsVoiceParams]/model_id`
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #3: ElevenLabsVoiceParams]/optimize_streaming_latency`
  - 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` — 2 info
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/speed`
  - added the optional property `voice/oneOf[subschema #4: PlayHtVoice]/speed` to the response with the `200` status
- **2023-10-13** `9feade6bcba8` — 2 breaking, 4 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 new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/version`
  - the request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/api_key` became optional
  - the request property `voice/anyOf[subschema #2]/oneOf[subschema #4: PlayHtVoiceParams]/api_user_id` became optional
  - added the optional property `voice/oneOf[subschema #4: PlayHtVoice]/version` to the response with the `200` status
- **2023-10-05** `f4d951d6fa94` — 1 breaking, 1 warning, 2 info
  - removed the enum value `event_machine_detection` of the request property `webhook/anyOf[subschema #2: WebhookParams]/subscriptions/items/`
  - added the new `event_human_detection` enum value to the `webhook/subscriptions/items/` response property for the response status `200`
  - added the new `event_human_detection` enum value to the request property `webhook/anyOf[subschema #2: WebhookParams]/subscriptions/items/`
  - 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, 5 info
  - the response property `prompt/content` became optional for the status `200`
  - added the new optional request property `prompt/anyOf[subschema #2: PromptParams]/prompt_template`
  - the request property `prompt/anyOf[subschema #2: PromptParams]/content` became optional
  - the `content` request property default value `` was added
  - 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` — 2 info
  - added the new optional request property `conversation_speed`
  - added the optional property `conversation_speed` to the response with the `200` status
- **2023-09-07** `c9ae97ec337f` — 4 info
  - added the new optional request property `ivr_navigation_mode`
  - added the new optional request property `voice/anyOf[subschema #2]/oneOf[subschema #2: RimeVoiceParams]/speed_alpha`
  - 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` — 2 breaking, 1 warning, 7 info
  - removed the enum value `field_type_address` of the request property `prompt/anyOf[subschema #2: PromptParams]/collect_fields/items/field_type`
  - 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 new optional request property `endpointing_sensitivity`
  - the request property `voice/anyOf[subschema #2]/oneOf[subschema #3: ElevenLabsVoiceParams]/api_key` became optional
  - the `noise_suppression` request property default value changed from `true` to `false`
  - added the new `event_machine_detection` enum value to the request property `webhook/anyOf[subschema #2: WebhookParams]/subscriptions/items/`
  - 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` — 2 info
  - added the new optional request property `noise_suppression`
  - added the optional property `noise_suppression` to the response with the `200` status
- **2023-08-26** `50986fe3a37f` — 2 breaking, 6 info
  - the `prompt` request property type changed from `string` to no type
  - the `prompt` response's property type changed from `string` to `object` for status `200`
  - added `#/components/schemas/PromptParams, subschema #1` to the `prompt` request property `anyOf` list
  - 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/create/post.md) · [API](https://skmtc.dev/vocodedev/apis/vocode-hosted-api.md) · [Page](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/agents/create/post)
