---
title: "Changes to Create an assistant"
method: POST
path: "/ai/assistants"
---

# Changes to Create an assistant

`POST /ai/assistants`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 15 of 47 revisions.

- **2026-06-05** `8a8c40f458c5` — 8 breaking, 8 info
- **2026-06-05** `3f3befefc607` — 2 breaking, 6 info
- **2026-06-04** `8a56feba7190` — 4 info
- **2026-06-04** `3390803c3bb0` — 2 info
- **2026-05-26** `ac6be9fa50c1` — 2 info
- **2026-05-20** `157ea860b82e` — 2 info
- **2026-05-18** `c260e29f1496` — 1 warning, 9 info
- **2026-05-14** `50870cc05614` — 4 breaking, 4 info
- **2026-05-14** `a144ff96b4ac` — 4 breaking, 4 info
- **2026-05-11** `24057b25c3f5` — 2 info
- **2026-05-08** `30cb1ddce91b` — 3 breaking, 7 warning, 45 info
- **2026-04-21** `e17ea465fdc4` — 2 info
- **2026-04-20** `83b0b3ef1a20` — 2 info
- **2026-04-17** `66523f014691` — 2 info
- **2026-04-16** `54c5a6e44be1` — 1 breaking, 1 info

## Changes

- **2026-06-05** `8a8c40f458c5` — 8 breaking, 8 info
  - removed `subschema #1: targets_list` from the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` request property `oneOf` list
  - removed `subschema #1: targets_list` from the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` request property `oneOf` list
  - added `subschema #1` to the `conversation_flow/nodes/items/oneOf[subschema #1: FlowNode]/tools/items/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1` to the `conversation_flow/nodes/items/oneOf[subschema #1: FlowNode]/tools/items/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1` to the `conversation_flow/nodes/items/oneOf[subschema #2: ToolNode]/tool/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1` to the `conversation_flow/nodes/items/oneOf[subschema #2: ToolNode]/tool/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1` to the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1` to the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1` to the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` request property `oneOf` list
  - added `subschema #1` to the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` request property `oneOf` list
  - removed `subschema #1: targets_list` from the `conversation_flow/nodes/items/oneOf[subschema #1: FlowNode]/tools/items/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - removed `subschema #1: targets_list` from the `conversation_flow/nodes/items/oneOf[subschema #1: FlowNode]/tools/items/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
  - removed `subschema #1: targets_list` from the `conversation_flow/nodes/items/oneOf[subschema #2: ToolNode]/tool/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - removed `subschema #1: targets_list` from the `conversation_flow/nodes/items/oneOf[subschema #2: ToolNode]/tool/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
  - removed `subschema #1: targets_list` from the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - removed `subschema #1: targets_list` from the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
- **2026-06-05** `3f3befefc607` — 2 breaking, 6 info
  - added `#/components/schemas/DefaultCondition` to the `conversation_flow/edges/items/condition` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SpeakNode` to the `conversation_flow/nodes/items/` response property `oneOf` list for the response status `200`
  - added `default` discriminator mapping keys to the `conversation_flow/edges/items/condition` request property
  - added `speak` discriminator mapping keys to the `conversation_flow/nodes/items/` request property
  - added `#/components/schemas/DefaultCondition` to the `conversation_flow/edges/items/condition` request property `oneOf` list
  - added `#/components/schemas/SpeakNodeReq` to the `conversation_flow/nodes/items/` request property `oneOf` list
  - added `default` discriminator mapping keys to the `conversation_flow/edges/items/condition` response property for the response status `200`
  - added `speak` discriminator mapping keys to the `conversation_flow/nodes/items/` response property for the response status `200`
- **2026-06-04** `8a56feba7190` — 4 info
  - added the new optional request property `tools/items/oneOf[subschema #5: TransferTool]/transfer/description`
  - added the optional property `conversation_flow/nodes/items/oneOf[subschema #1: FlowNode]/tools/items/items/oneOf[subschema #5: TransferTool]/transfer/description` to the response with the `200` status
  - added the optional property `conversation_flow/nodes/items/oneOf[subschema #2: ToolNode]/tool/items/oneOf[subschema #5: TransferTool]/transfer/description` to the response with the `200` status
  - added the optional property `tools/items/oneOf[subschema #5: TransferTool]/transfer/description` to the response with the `200` status
- **2026-06-04** `3390803c3bb0` — 2 info
  - added the new optional request property `conversation_flow`
  - added the optional property `conversation_flow` to the response with the `200` status
- **2026-05-26** `ac6be9fa50c1` — 2 info
  - added the new optional request property `telephony_settings/recording_settings/stop_on_conversation_end`
  - added the optional property `telephony_settings/recording_settings/stop_on_conversation_end` to the response with the `200` status
- **2026-05-20** `157ea860b82e` — 2 info
  - added the new optional request property `tools/items/oneOf[subschema #1: WebhookTool]/webhook/async_timeout_ms`
  - added the optional property `tools/items/oneOf[subschema #1: WebhookTool]/webhook/async_timeout_ms` to the response with the `200` status
- **2026-05-18** `c260e29f1496` — 1 warning, 9 info
  - added the new `soniox/stt-rt-v4` enum value to the `transcription/model` response property for the response status `200`
  - added the new optional request property `transcription/settings/enable_endpoint_detection`
  - added the new optional request property `transcription/settings/interim_results`
  - added the new optional request property `transcription/settings/max_endpoint_delay_ms`
  - added the new optional request property `voice_settings/background_audio/oneOf[subschema #1]/volume`
  - added the new `soniox/stt-rt-v4` enum value to the request property `transcription/model`
  - added the optional property `transcription/settings/enable_endpoint_detection` to the response with the `200` status
  - added the optional property `transcription/settings/interim_results` to the response with the `200` status
  - added the optional property `transcription/settings/max_endpoint_delay_ms` to the response with the `200` status
  - added the optional property `voice_settings/background_audio/oneOf[subschema #1]/volume` to the response with the `200` status
- **2026-05-14** `50870cc05614` — 4 breaking, 4 info
  - removed `subschema #1` from the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` request property `oneOf` list
  - removed `subschema #1` from the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` request property `oneOf` list
  - added `subschema #1: targets_list` to the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1: targets_list` to the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1: targets_list` to the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` request property `oneOf` list
  - added `subschema #1: targets_list` to the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` request property `oneOf` list
  - removed `subschema #1` from the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - removed `subschema #1` from the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
- **2026-05-14** `a144ff96b4ac` — 4 breaking, 4 info
  - removed `subschema #1: targets_list` from the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` request property `oneOf` list
  - removed `subschema #1: targets_list` from the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` request property `oneOf` list
  - added `subschema #1` to the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1` to the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
  - added `subschema #1` to the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` request property `oneOf` list
  - added `subschema #1` to the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` request property `oneOf` list
  - removed `subschema #1: targets_list` from the `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` response property `oneOf` list for the response status `200`
  - removed `subschema #1: targets_list` from the `tools/items/oneOf[subschema #6: InviteTool]/invite/targets` response property `oneOf` list for the response status `200`
- **2026-05-11** `24057b25c3f5` — 2 info
  - the `eager_eot_threshold` request property default value changed from `0.4` to `0.8`
  - the `eager_eot_threshold` response's property default value changed from `0.4` to `0.8` for the status `200`
- **2026-05-08** `30cb1ddce91b` — 3 breaking, 7 warning, 45 info
  - added the new required request property `tools/items/oneOf[subschema #6: InviteTool]/invite`
  - response property `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` list-of-types was widened by adding types `string` to media type `application/json` of response `200`
  - removed the required property `tools/items/oneOf[subschema #6: InviteTool]/invite_config` from the response with the `200` status
  - the `transcription/settings/eot_threshold` request property's max was set to `0.90`
  - the `transcription/settings/eot_timeout_ms` request property's max was set to `10000.00`
  - the `transcription/settings/eot_threshold` request property's min was set to `0.50`
  - the `transcription/settings/eot_timeout_ms` request property's min was set to `500.00`
  - removed the request property `tools/items/oneOf[subschema #6: InviteTool]/invite_config`
  - added the new `assemblyai/universal-streaming` enum value to the `transcription/model` response property for the response status `200`
  - added the new `xai/grok-stt` enum value to the `transcription/model` response property for the response status `200`
  - added the new optional request property `dynamic_variables_webhook_timeout_ms`
  - added the new optional request property `external_llm`
  - added the new optional request property `fallback_config`
  - added the new optional request property `integrations`
  - added the new optional request property `interruption_settings`
  - added the new optional request property `mcp_servers`
  - added the new optional request property `observability_settings/prompt_label`
  - added the new optional request property `observability_settings/prompt_name`
  - added the new optional request property `observability_settings/prompt_sync`
  - added the new optional request property `observability_settings/prompt_version`
  - added the new optional request property `tags`
  - added the new optional request property `transcription/api_key_ref`
  - added the new optional request property `transcription/settings/end_of_turn_confidence_threshold`
  - added the new optional request property `transcription/settings/max_turn_silence`
  - added the new optional request property `transcription/settings/min_turn_silence`
  - the request property `model` became optional
  - the `eot_threshold` request property default value `0.8` was added
  - the `eot_timeout_ms` request property default value `5000` was added
  - the `eager_eot_threshold` request property default value changed from `0.3` to `0.4`
  - added the new `assemblyai/universal-streaming` enum value to the request property `transcription/model`
  - added the new `xai/grok-stt` enum value to the request property `transcription/model`
  - request property `tools/items/oneOf[subschema #5: TransferTool]/transfer/targets` list-of-types was widened by adding types `string` to media type `application/json`
  - added the optional property `dynamic_variables_webhook_timeout_ms` to the response with the `200` status
  - added the optional property `external_llm` to the response with the `200` status
  - added the optional property `fallback_config` to the response with the `200` status
  - added the optional property `integrations` to the response with the `200` status
  - added the optional property `interruption_settings` to the response with the `200` status
  - added the optional property `mcp_servers` to the response with the `200` status
  - added the optional property `observability_settings/prompt_label` to the response with the `200` status
  - added the optional property `observability_settings/prompt_name` to the response with the `200` status
  - …15 more
- **2026-04-21** `e17ea465fdc4` — 2 info
  - added the new optional request property `post_conversation_settings`
  - added the optional property `post_conversation_settings` to the response with the `200` status
- **2026-04-20** `83b0b3ef1a20` — 2 info
  - added the new optional request property `transcription/settings/keyterm`
  - added the optional property `transcription/settings/keyterm` to the response with the `200` status
- **2026-04-17** `66523f014691` — 2 info
  - added the new optional request property `telephony_settings/user_idle_reply_secs`
  - added the optional property `telephony_settings/user_idle_reply_secs` to the response with the `200` status
- **2026-04-16** `54c5a6e44be1` — 1 breaking, 1 info
  - the `telephony_settings/user_idle_timeout_secs` response property's min was decreased from `30.00` to `10.00` for the response status `200`
  - the `telephony_settings/user_idle_timeout_secs` request property's min was decreased from `30.00` to `10.00`

---

[Operation](https://skmtc.dev/team-telnyx/apis/telnyx-api/docs/ai/assistants/post.md) · [API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) · [Page](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/ai/assistants/post)
