---
title: "Changes to PATCH /update-chat-agent/{agent_id}"
method: PATCH
path: "/update-chat-agent/{agent_id}"
---

# Changes to PATCH /update-chat-agent/{agent_id}

`PATCH /update-chat-agent/{agent_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 15 of 28 revisions.

- **2026-05-18** `6342a9990108` — 2 warning
- **2026-05-08** `7dd16ddf69d8` — 2 info
- **2026-05-08** `a109c375a367` — 1 warning
- **2026-05-07** `f1a0d7c1e36c` — 1 breaking, 1 warning, 5 info
- **2026-04-28** `1b4a9d84942a` — 1 warning, 1 info
- **2026-04-27** `a44406f743c2` — 42 breaking, 40 info
- **2026-04-20** `8ee53928bf31` — 1 warning, 1 info
- **2026-04-01** `56de19127afb` — 2 breaking, 6 info
- **2026-03-19** `3aa6f6e028ef` — 2 warning, 2 info
- **2026-03-17** `424df3aa7900` — 1 warning, 1 info
- **2026-03-09** `8fbf8c54a142` — 6 breaking, 1 warning, 10 info
- **2026-02-23** `bcff6899fa2a` — 4 info
- **2026-02-11** `076d0088c7ed` — 1 warning, 1 info
- **2026-02-10** `0bf5cea5dfcc` — 2 info
- **2026-02-06** `dfad228ab4a4` — 2 info

## Changes

- **2026-05-18** `6342a9990108` — 2 warning
  - removed the request property `is_public`
  - removed the optional property `allOf[#/components/schemas/ChatAgentRequest]/is_public` from the response with the `200` status
- **2026-05-08** `7dd16ddf69d8` — 2 info
  - `query` request parameter `version` list-of-types was widened by adding types `string`
  - for the `query` request parameter `version`, the type was generalized from `integer` to no type
- **2026-05-08** `a109c375a367` — 1 warning
  - removed the optional property `allOf[subschema #3]/response_engine_data` from the response with the `200` status
- **2026-05-07** `f1a0d7c1e36c` — 1 breaking, 1 warning, 5 info
  - removed the enum value `gemini-2.5-flash` of the request property `post_chat_analysis_model`
  - added the new `transcript_updated` enum value to the `allOf[#/components/schemas/ChatAgentRequest]/webhook_events/items/` response property for the response status `200`
  - added the new `transcript_updated` enum value to the request property `webhook_events/items/`
  - added `subschema #1, subschema #3` to the response body `allOf` list for the response status `200`
  - removed `subschema #1, subschema #3` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `412`
  - removed the `gemini-2.5-flash` enum value from the `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `200`
- **2026-04-28** `1b4a9d84942a` — 1 warning, 1 info
  - added the new `gpt-5.5` enum value to the `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `200`
  - added the new `gpt-5.5` enum value to the request property `post_chat_analysis_model`
- **2026-04-27** `a44406f743c2` — 42 breaking, 40 info
  - removed the enum value `bg-BG` of the request property `language`
  - removed the enum value `ca-ES` of the request property `language`
  - removed the enum value `cs-CZ` of the request property `language`
  - removed the enum value `da-DK` of the request property `language`
  - removed the enum value `de-DE` of the request property `language`
  - removed the enum value `el-GR` of the request property `language`
  - removed the enum value `en-AU` of the request property `language`
  - removed the enum value `en-GB` of the request property `language`
  - removed the enum value `en-IN` of the request property `language`
  - removed the enum value `en-NZ` of the request property `language`
  - removed the enum value `en-US` of the request property `language`
  - removed the enum value `es-419` of the request property `language`
  - removed the enum value `es-ES` of the request property `language`
  - removed the enum value `fi-FI` of the request property `language`
  - removed the enum value `fr-CA` of the request property `language`
  - removed the enum value `fr-FR` of the request property `language`
  - removed the enum value `hi-IN` of the request property `language`
  - removed the enum value `hu-HU` of the request property `language`
  - removed the enum value `id-ID` of the request property `language`
  - removed the enum value `it-IT` of the request property `language`
  - removed the enum value `ja-JP` of the request property `language`
  - removed the enum value `ko-KR` of the request property `language`
  - removed the enum value `lt-LT` of the request property `language`
  - removed the enum value `lv-LV` of the request property `language`
  - removed the enum value `multi` of the request property `language`
  - removed the enum value `nl-BE` of the request property `language`
  - removed the enum value `nl-NL` of the request property `language`
  - removed the enum value `no-NO` of the request property `language`
  - removed the enum value `pl-PL` of the request property `language`
  - removed the enum value `pt-BR` of the request property `language`
  - removed the enum value `pt-PT` of the request property `language`
  - removed the enum value `ro-RO` of the request property `language`
  - removed the enum value `ru-RU` of the request property `language`
  - removed the enum value `sk-SK` of the request property `language`
  - removed the enum value `sv-SE` of the request property `language`
  - removed the enum value `th-TH` of the request property `language`
  - removed the enum value `tr-TR` of the request property `language`
  - removed the enum value `vi-VN` of the request property `language`
  - removed the enum value `zh-CN` of the request property `language`
  - the `language` request property type changed from `string` to no type
  - …42 more
- **2026-04-20** `8ee53928bf31` — 1 warning, 1 info
  - added the new `gemini-3.1-flash-lite` enum value to the `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `200`
  - added the new `gemini-3.1-flash-lite` enum value to the request property `post_chat_analysis_model`
- **2026-04-01** `56de19127afb` — 2 breaking, 6 info
  - removed `#/components/schemas/StringAnalysisData, #/components/schemas/EnumAnalysisData, #/components/schemas/BooleanAnalysisData, #/components/schemas/NumberAnalysisData` from the `post_chat_analysis_data/items/` request property `oneOf` list
  - added `#/components/schemas/AnalysisData, #/components/schemas/ChatPresetAnalysisData` to the `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_data/items/` response property `oneOf` list for the response status `200`
  - added the new optional request property `handbook_config`
  - added the new optional request property `timezone`
  - added `#/components/schemas/AnalysisData, #/components/schemas/ChatPresetAnalysisData` to the `post_chat_analysis_data/items/` request property `oneOf` list
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/handbook_config` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/timezone` to the response with the `200` status
  - removed `#/components/schemas/StringAnalysisData, #/components/schemas/EnumAnalysisData, #/components/schemas/BooleanAnalysisData, #/components/schemas/NumberAnalysisData` from the `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_data/items/` response property `oneOf` list for the response status `200`
- **2026-03-19** `3aa6f6e028ef` — 2 warning, 2 info
  - added the new `gpt-5.4-mini` enum value to the `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `200`
  - added the new `gpt-5.4-nano` enum value to the `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `200`
  - added the new `gpt-5.4-mini` enum value to the request property `post_chat_analysis_model`
  - added the new `gpt-5.4-nano` enum value to the request property `post_chat_analysis_model`
- **2026-03-17** `424df3aa7900` — 1 warning, 1 info
  - added the new `gpt-5.4` enum value to the `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `200`
  - added the new `gpt-5.4` enum value to the request property `post_chat_analysis_model`
- **2026-03-09** `8fbf8c54a142` — 6 breaking, 1 warning, 10 info
  - for the `path` request parameter `agent_id`, the minLength was increased from `0` to `1`
  - the `post_chat_analysis_data/items/oneOf[#/components/schemas/BooleanAnalysisData]/name` request property's minLength was increased from `0` to `1`
  - the `post_chat_analysis_data/items/oneOf[#/components/schemas/EnumAnalysisData]/name` request property's minLength was increased from `0` to `1`
  - the `post_chat_analysis_data/items/oneOf[#/components/schemas/NumberAnalysisData]/name` request property's minLength was increased from `0` to `1`
  - the `post_chat_analysis_data/items/oneOf[#/components/schemas/StringAnalysisData]/name` request property's minLength was increased from `0` to `1`
  - the response property `allOf[#/components/schemas/ChatAgentRequest]/end_chat_after_silence_ms` became nullable for the status `200`
  - added the new `claude-4.6-sonnet` enum value to the `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `200`
  - added the new optional request property `post_chat_analysis_data/items/oneOf[#/components/schemas/BooleanAnalysisData]/required`
  - added the new optional request property `post_chat_analysis_data/items/oneOf[#/components/schemas/EnumAnalysisData]/required`
  - added the new optional request property `post_chat_analysis_data/items/oneOf[#/components/schemas/NumberAnalysisData]/required`
  - added the new optional request property `post_chat_analysis_data/items/oneOf[#/components/schemas/StringAnalysisData]/required`
  - the request property `end_chat_after_silence_ms` became nullable
  - added the new `claude-4.6-sonnet` enum value to the request property `post_chat_analysis_model`
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_data/items/oneOf[#/components/schemas/BooleanAnalysisData]/required` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_data/items/oneOf[#/components/schemas/EnumAnalysisData]/required` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_data/items/oneOf[#/components/schemas/NumberAnalysisData]/required` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_data/items/oneOf[#/components/schemas/StringAnalysisData]/required` to the response with the `200` status
- **2026-02-23** `bcff6899fa2a` — 4 info
  - added the new optional request property `analysis_user_sentiment_prompt`
  - added the new optional request property `data_storage_retention_days`
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/analysis_user_sentiment_prompt` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/data_storage_retention_days` to the response with the `200` status
- **2026-02-11** `076d0088c7ed` — 1 warning, 1 info
  - added the new `cs-CZ` enum value to the `allOf[#/components/schemas/ChatAgentRequest]/language` response property for the response status `200`
  - added the new `cs-CZ` enum value to the request property `language`
- **2026-02-10** `0bf5cea5dfcc` — 2 info
  - added the new optional request property `webhook_events`
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/webhook_events` to the response with the `200` status
- **2026-02-06** `dfad228ab4a4` — 2 info
  - added the new optional request property `guardrail_config`
  - added the optional property `allOf[#/components/schemas/ChatAgentRequest]/guardrail_config` to the response with the `200` status

---

[Operation](https://skmtc.dev/retellai/apis/retell-sdk/docs/update-chat-agent/:agent_id/patch.md) · [API](https://skmtc.dev/retellai/apis/retell-sdk.md) · [Page](https://skmtc.dev/retellai/apis/retell-sdk/changes/update-chat-agent/:agent_id/patch)
