---
title: "Changes to Edit Agent"
method: PUT
path: "/agents/{agent_id}"
---

# Changes to Edit Agent

`PUT /agents/{agent_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 22 revisions.

- **2026-10-16** `4abdda722de9`: 1 info
- **2025-10-28** `c8152db45500`: 1 warning, 4 info
- **2025-08-26** `db7245c74772`: 4 info
- **2025-05-08** `17bdb8a33fb4`: 5 info
- **2025-03-11** `194878b194cd`: 2 info
- **2025-02-26** `5298551c424b`: 1 breaking, 2 info
- **2025-01-14** `4dd01a1cc34b`: 1 info

## Changes

- **2026-10-16** `4abdda722de9`: 1 info
  - added the new optional request property `agent_configs/generate_response_config/model`
- **2025-10-28** `c8152db45500`: 1 warning, 4 info
  - removed the request property `llm_model_id`
  - added the new optional request property `agent_configs/acl_config`
  - added the new optional request property `agent_configs/translation_config`
  - added the new optional request property `description`
  - added the new optional request property `name`
- **2025-08-26** `db7245c74772`: 4 info
  - added the new optional request property `agent_configs/filter_and_rerank_config/default_metadata_filters`
  - added the new optional request property `agent_configs/filter_and_rerank_config/per_datastore_metadata_filters`
  - added the new optional request property `agent_configs/reformulation_config`
  - added the new optional request property `multiturn_system_prompt`
- **2025-05-08** `17bdb8a33fb4`: 5 info
  - added the new optional request property `agent_configs/filter_and_rerank_config/rerank_instructions`
  - added the new optional request property `agent_configs/filter_and_rerank_config/reranker_score_filter_threshold`
  - added the new optional request property `agent_configs/generate_response_config/avoid_commentary`
  - added the new optional request property `agent_configs/global_config/should_check_retrieval_need`
  - added the new optional request property `no_retrieval_system_prompt`
- **2025-03-11** `194878b194cd`: 2 info
  - added the new optional request property `agent_configs/generate_response_config/calculate_groundedness`
  - added the new optional request property `filter_prompt`
- **2025-02-26** `5298551c424b`: 1 breaking, 2 info
  - the `system_prompt` request property's maxLength was decreased to `8000`
  - added the new optional request property `agent_configs`
  - the `datastore_ids` request property's minLength was decreased from `1` to `0`
- **2025-01-14** `4dd01a1cc34b`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/contextualai/apis/endpoints/docs/agents/:agent_id/put.md) - [API](https://skmtc.dev/contextualai/apis/endpoints.md) - [Page](https://skmtc.dev/contextualai/apis/endpoints/changes/agents/:agent_id/put)