---
title: "Changes to Simulates A Conversation"
method: POST
path: "/v1/convai/agents/{agent_id}/simulate-conversation"
---

# Changes to Simulates A Conversation

`POST /v1/convai/agents/{agent_id}/simulate-conversation`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 15 of 32 revisions.

- **2026-09-04** `d393c67c384a` — 9 breaking, 38 info
- **2026-09-02** `630c650dda66` — 3 info
- **2026-08-31** `aa277505183c` — 8 breaking, 24 info
- **2026-08-27** `f366bca2ae3c` — 1 warning, 10 info
- **2026-08-25** `311280aae31f` — 2 info
- **2026-08-19** `f053c821dc18` — 3 breaking, 28 info
- **2026-08-15** `acb0175c0525` — 1 warning, 4 info
- **2026-08-11** `d1a4847203ce` — 1 warning, 5 info
- **2026-08-08** `e77a0a530a82` — 19 info
- **2026-08-06** `1cae8adcc965` — 9 info
- **2026-08-05** `ebff0190de5c` — 1 warning, 13 info
- **2026-08-04** `ff0371798660` — 2 breaking, 8 info
- **2026-08-04** `7dac1812fdca` — 2 breaking, 6 info
- **2026-07-31** `72c54eba117e` — 2 breaking, 35 info
- **2026-07-26** `494d96419d15` — 12 breaking, 5 warning, 183 info

## Changes

- **2026-09-04** `d393c67c384a` — 9 breaking, 38 info
  - removed `#/components/schemas/QueryParamsJsonSchema` from the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/query_params_schema` request property `anyOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/RunSubagentToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params` request property `oneOf` list
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/path_params_schema/additionalProperties/allowed_values`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/request_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/request_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/response_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/response_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #2: ClientToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #2: ClientToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #4: MCPToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #4: MCPToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values`
  - added `#/components/schemas/QueryParamsJsonSchema-Input` to the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/query_params_schema` request property `anyOf` list
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/path_params_schema/additionalProperties/allowed_values_dynamic_variable` deprecated
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/request_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values_dynamic_variable` deprecated
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/request_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values_dynamic_variable` deprecated
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/response_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values_dynamic_variable` deprecated
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/response_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values_dynamic_variable` deprecated
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #2: ClientToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values_dynamic_variable` deprecated
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #2: ClientToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values_dynamic_variable` deprecated
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #4: MCPToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values_dynamic_variable` deprecated
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #4: MCPToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values_dynamic_variable` deprecated
  - added `create_product_quote_request, create_service_quote_request, send_custom_email` discriminator mapping keys to the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #6: SMBToolConfig]/params` request property
  - removed `run_subagent` discriminator mapping keys from the `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params` request property
  - removed `run_subagent` discriminator mapping keys from the `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params` request property
  - removed `run_subagent` discriminator mapping keys from the `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params` request property
  - removed `run_subagent` discriminator mapping keys from the `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params` request property
  - removed `run_subagent` discriminator mapping keys from the `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params` request property
  - removed `run_subagent` discriminator mapping keys from the `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params` request property
  - removed `run_subagent` discriminator mapping keys from the `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params` request property
  - removed `run_subagent` discriminator mapping keys from the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params` request property
  - added `#/components/schemas/SendCustomEmailParams, #/components/schemas/CreateServiceQuoteRequestParams, #/components/schemas/CreateProductQuoteRequestParams` to the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #6: SMBToolConfig]/params` request property `oneOf` list
  - added the optional property `analysis/data_collection_results/additionalProperties/json_schema/anyOf[subschema #1: LiteralJsonSchemaProperty]/allowed_values` to the response with the `200` status
  - added the optional property `analysis/data_collection_results/additionalProperties/name` to the response with the `200` status
  - …7 more
- **2026-09-02** `630c650dda66` — 3 info
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/rag/knowledge_base_tool_info`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/follow_redirects`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/follow_redirects_allowed_domains`
- **2026-08-31** `aa277505183c` — 8 breaking, 24 info
  - removed `#/components/schemas/StartProcedureToolConfig-Input, #/components/schemas/EndProcedureToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/StartProcedureToolConfig-Input, #/components/schemas/EndProcedureToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/StartProcedureToolConfig-Input, #/components/schemas/EndProcedureToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/StartProcedureToolConfig-Input, #/components/schemas/EndProcedureToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/StartProcedureToolConfig-Input, #/components/schemas/EndProcedureToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/StartProcedureToolConfig-Input, #/components/schemas/EndProcedureToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/StartProcedureToolConfig-Input, #/components/schemas/EndProcedureToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - removed `#/components/schemas/StartProcedureToolConfig-Input, #/components/schemas/EndProcedureToolConfig-Input` from the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params` request property `oneOf` list
  - mapped value for discriminator key `end_procedure` changed from `#/components/schemas/EndProcedureToolConfig-Input` to `#/components/schemas/EndProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `end_procedure` changed from `#/components/schemas/EndProcedureToolConfig-Input` to `#/components/schemas/EndProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `end_procedure` changed from `#/components/schemas/EndProcedureToolConfig-Input` to `#/components/schemas/EndProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `end_procedure` changed from `#/components/schemas/EndProcedureToolConfig-Input` to `#/components/schemas/EndProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `end_procedure` changed from `#/components/schemas/EndProcedureToolConfig-Input` to `#/components/schemas/EndProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `end_procedure` changed from `#/components/schemas/EndProcedureToolConfig-Input` to `#/components/schemas/EndProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `end_procedure` changed from `#/components/schemas/EndProcedureToolConfig-Input` to `#/components/schemas/EndProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `end_procedure` changed from `#/components/schemas/EndProcedureToolConfig-Input` to `#/components/schemas/EndProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params` request property
  - mapped value for discriminator key `start_procedure` changed from `#/components/schemas/StartProcedureToolConfig-Input` to `#/components/schemas/StartProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `start_procedure` changed from `#/components/schemas/StartProcedureToolConfig-Input` to `#/components/schemas/StartProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `start_procedure` changed from `#/components/schemas/StartProcedureToolConfig-Input` to `#/components/schemas/StartProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `start_procedure` changed from `#/components/schemas/StartProcedureToolConfig-Input` to `#/components/schemas/StartProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `start_procedure` changed from `#/components/schemas/StartProcedureToolConfig-Input` to `#/components/schemas/StartProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `start_procedure` changed from `#/components/schemas/StartProcedureToolConfig-Input` to `#/components/schemas/StartProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `start_procedure` changed from `#/components/schemas/StartProcedureToolConfig-Input` to `#/components/schemas/StartProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params` request property
  - mapped value for discriminator key `start_procedure` changed from `#/components/schemas/StartProcedureToolConfig-Input` to `#/components/schemas/StartProcedureToolConfig` for `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params` request property
  - added `#/components/schemas/StartProcedureToolConfig, #/components/schemas/EndProcedureToolConfig` to the `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - added `#/components/schemas/StartProcedureToolConfig, #/components/schemas/EndProcedureToolConfig` to the `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - added `#/components/schemas/StartProcedureToolConfig, #/components/schemas/EndProcedureToolConfig` to the `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - added `#/components/schemas/StartProcedureToolConfig, #/components/schemas/EndProcedureToolConfig` to the `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - added `#/components/schemas/StartProcedureToolConfig, #/components/schemas/EndProcedureToolConfig` to the `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - added `#/components/schemas/StartProcedureToolConfig, #/components/schemas/EndProcedureToolConfig` to the `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - added `#/components/schemas/StartProcedureToolConfig, #/components/schemas/EndProcedureToolConfig` to the `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params` request property `oneOf` list
  - added `#/components/schemas/StartProcedureToolConfig, #/components/schemas/EndProcedureToolConfig` to the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params` request property `oneOf` list
- **2026-08-27** `f366bca2ae3c` — 1 warning, 10 info
  - added the new `dtmf` enum value to the `simulated_conversation/items/source_medium/anyOf[subschema #1: ChatSourceMedium]/` response property for the response status `200`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #4: TransferToNumberToolConfig]/transfers/items/sip_refer_play_dialtone`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #4: TransferToNumberToolConfig]/transfers/items/sip_refer_play_dialtone`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #4: TransferToNumberToolConfig]/transfers/items/sip_refer_play_dialtone`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #4: TransferToNumberToolConfig]/transfers/items/sip_refer_play_dialtone`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #4: TransferToNumberToolConfig]/transfers/items/sip_refer_play_dialtone`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #4: TransferToNumberToolConfig]/transfers/items/sip_refer_play_dialtone`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #4: TransferToNumberToolConfig]/transfers/items/sip_refer_play_dialtone`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params/oneOf[subschema #4: TransferToNumberToolConfig]/transfers/items/sip_refer_play_dialtone`
  - added the new `dtmf` enum value to the request property `simulation_specification/partial_conversation_history/items/source_medium/anyOf[subschema #1: ChatSourceMedium]/`
  - added the optional property `simulated_conversation/items/file_inputs` to the response with the `200` status
- **2026-08-25** `311280aae31f` — 2 info
  - added `cancel_order, create_order, get_client_orders, get_order_by_confirmation_number, update_order` discriminator mapping keys to the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #6: SMBToolConfig]/params` request property
  - added `#/components/schemas/CreateOrderParams, #/components/schemas/GetOrderByConfirmationNumberParams, #/components/schemas/GetClientOrdersParams, #/components/schemas/UpdateOrderParams, #/components/schemas/CancelOrderParams` to the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #6: SMBToolConfig]/params` request property `oneOf` list
- **2026-08-19** `f053c821dc18` — 3 breaking, 28 info
  - response property `analysis/data_collection_results/additionalProperties/json_schema/anyOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `analysis/data_collection_results_list/items/json_schema/anyOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `analysis/scoped/items/data_collection_results/additionalProperties/json_schema/anyOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/path_params_schema/additionalProperties/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/query_params_schema/anyOf[subschema #1: QueryParamsJsonSchema]/properties/additionalProperties/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/request_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/request_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/response_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/api_schema/response_body_schema/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #2: ClientToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #2: ClientToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params/oneOf[subschema #12: RunSubagentToolConfig]/agents/items/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #4: MCPToolConfig]/input_overrides/anyOf[subschema #1]/additionalProperties/oneOf[subschema #1: ConstantSchemaOverride]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #4: MCPToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #4: MCPToolConfig]/parameters/anyOf[subschema #1: ObjectJsonSchemaProperty]/properties/additionalProperties/oneOf[subschema #3: ArrayJsonSchemaProperty]/items/oneOf[subschema #1: LiteralJsonSchemaProperty]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #5: ApiIntegrationWebhookToolConfig]/api_schema_overrides/anyOf[subschema #1: ApiIntegrationWebhookOverrides]/schema_overrides/anyOf[subschema #1]/additionalProperties/oneOf[subschema #1: ConstantSchemaOverride]/constant_value` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-08-15** `acb0175c0525` — 1 warning, 4 info
  - added the new `gemini-3.7-flash` enum value to the `simulated_conversation/items/llm_usage/anyOf[subschema #1: LLMUsage]/model_usage/propertyNames/` response property for the response status `200`
  - added the new `gemini-3.7-flash` enum value to the request property `extra_evaluation_criteria/anyOf[subschema #1]/items/llm/anyOf[subschema #1: LLM]/`
  - added the new `gemini-3.7-flash` enum value to the request property `simulation_specification/partial_conversation_history/items/llm_usage/anyOf[subschema #1: LLMUsage]/model_usage/propertyNames/`
  - added the new `gemini-3.7-flash` enum value to the request property `simulation_specification/simulated_user_config/prompt/backup_llm_config/oneOf[subschema #3: BackupLLMOverride]/order/items/`
  - added the new `gemini-3.7-flash` enum value to the request property `simulation_specification/simulated_user_config/prompt/llm`
- **2026-08-11** `d1a4847203ce` — 1 warning, 5 info
  - added the new `gemini-3.6-flash` enum value to the `simulated_conversation/items/llm_usage/anyOf[subschema #1: LLMUsage]/model_usage/propertyNames/` response property for the response status `200`
  - added the new `avaya` enum value to the request property `simulation_specification/simulated_user_config/text_behavior_overrides/anyOf[subschema #1]/propertyNames/`
  - added the new `gemini-3.6-flash` enum value to the request property `extra_evaluation_criteria/anyOf[subschema #1]/items/llm/anyOf[subschema #1: LLM]/`
  - added the new `gemini-3.6-flash` enum value to the request property `simulation_specification/partial_conversation_history/items/llm_usage/anyOf[subschema #1: LLMUsage]/model_usage/propertyNames/`
  - added the new `gemini-3.6-flash` enum value to the request property `simulation_specification/simulated_user_config/prompt/backup_llm_config/oneOf[subschema #3: BackupLLMOverride]/order/items/`
  - added the new `gemini-3.6-flash` enum value to the request property `simulation_specification/simulated_user_config/prompt/llm`
- **2026-08-08** `e77a0a530a82` — 19 info
  - added the new optional request property `simulation_specification/partial_conversation_history/items/producing_llm`
  - the `ignore_default_personality` request property default value changed from `false` to `true`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - the `model` request property default value changed from `gemini-2.5-flash-lite` to `gemini-3.1-flash-lite`
  - added the optional property `simulated_conversation/items/producing_llm` to the response with the `200` status
- **2026-08-06** `1cae8adcc965` — 9 info
  - the `` request property default value `gemini-2.5-flash` was removed
  - the `` request property default value `gemini-2.5-flash` was removed
  - the `` request property default value `gemini-2.5-flash` was removed
  - added `create_transfer_rule, delete_transfer_rule, list_transfer_rules, update_transfer_rule` discriminator mapping keys to the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #6: SMBToolConfig]/params` request property
  - added the new `audiocodes` enum value to the request property `simulation_specification/simulated_user_config/text_behavior_overrides/anyOf[subschema #1]/propertyNames/`
  - the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #1: WebhookToolConfig]/response_timeout_secs` request property's max was increased from `120.00` to `300.00`
  - the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #5: ApiIntegrationWebhookToolConfig]/response_timeout_secs` request property's max was increased from `120.00` to `300.00`
  - added `#/components/schemas/ListTransferRulesParams, #/components/schemas/CreateTransferRuleParams, #/components/schemas/UpdateTransferRuleParams, #/components/schemas/DeleteTransferRuleParams` to the `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #6: SMBToolConfig]/params` request property `oneOf` list
  - the `` response's property default value `gemini-2.5-flash` was removed for the status `200`
- **2026-08-05** `ebff0190de5c` — 1 warning, 13 info
  - added the new `gemini-3.5-flash-lite` enum value to the `simulated_conversation/items/llm_usage/anyOf[subschema #1: LLMUsage]/model_usage/propertyNames/` response property for the response status `200`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/end_call/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #2: LanguageDetectionToolConfig]/only_at_conversation_start`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/language_detection/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #2: LanguageDetectionToolConfig]/only_at_conversation_start`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/play_keypad_touch_tone/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #2: LanguageDetectionToolConfig]/only_at_conversation_start`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/skip_turn/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #2: LanguageDetectionToolConfig]/only_at_conversation_start`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_agent/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #2: LanguageDetectionToolConfig]/only_at_conversation_start`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/transfer_to_number/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #2: LanguageDetectionToolConfig]/only_at_conversation_start`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/built_in_tools/voicemail_detection/anyOf[subschema #1: SystemToolConfig]/params/oneOf[subschema #2: LanguageDetectionToolConfig]/only_at_conversation_start`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #3: SystemToolConfig]/params/oneOf[subschema #2: LanguageDetectionToolConfig]/only_at_conversation_start`
  - added the new optional request property `simulation_specification/simulated_user_config/prompt/tools/items/oneOf[subschema #6: SMBToolConfig]/human_description`
  - added the new `gemini-3.5-flash-lite` enum value to the request property `extra_evaluation_criteria/anyOf[subschema #1]/items/llm/anyOf[subschema #1: LLM]/`
  - added the new `gemini-3.5-flash-lite` enum value to the request property `simulation_specification/partial_conversation_history/items/llm_usage/anyOf[subschema #1: LLMUsage]/model_usage/propertyNames/`
  - added the new `gemini-3.5-flash-lite` enum value to the request property `simulation_specification/simulated_user_config/prompt/backup_llm_config/oneOf[subschema #3: BackupLLMOverride]/order/items/`
  - added the new `gemini-3.5-flash-lite` enum value to the request property `simulation_specification/simulated_user_config/prompt/llm`
- …earlier changes are on the page: https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/agents/:agent_id/simulate-conversation/post

---

[Operation](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/docs/v1/convai/agents/:agent_id/simulate-conversation/post.md) · [API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) · [Page](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/agents/:agent_id/simulate-conversation/post)
