---
title: "Changes to Update Agent"
method: PATCH
path: "/v1/task-agents/{agent_id}"
---

# Changes to Update Agent

`PATCH /v1/task-agents/{agent_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 56 revisions.

- **2026-08-17** `22c2a2291146`: 1 warning
- **2026-07-20** `d4e4f170f4f4`: 2 warning, 5 info
- **2026-07-13** `e8a97dc9fce2`: 1 breaking, 7 warning, 16 info
- **2026-06-18** `2562e655b8f2`: 1 breaking, 4 info
- **2026-06-11** `421a9851d61b`: 1 info

## Changes

- **2026-08-17** `22c2a2291146`: 1 warning
  - added the new `5x-high` enum value to the `effort` response property for the response status `200`
- **2026-07-20** `d4e4f170f4f4`: 2 warning, 5 info
  - removed the optional property `account_id` from the response with the `200` status
  - removed the optional property `workspace_id` from the response with the `200` status
  - api operation id `update_agent_api_v2_public_web_search_agents__agent_id__patch` removed and replaced with `update_agent_public_v1_api_v1_public_web_search_agents__agent_id__patch`
  - endpoint deprecated
  - the `allow` response's property default value `` was removed for the status `200`
  - the `block` response's property default value `` was removed for the status `200`
  - added the required property `sources/block/items/id` to the response with the `200` status
- **2026-07-13** `e8a97dc9fce2`: 1 breaking, 7 warning, 16 info
  - for the `path` request parameter `agent_id`, the format changed from no format to `uuid`
  - deleted the `cookie` request parameter `token`
  - removed the optional property `workspace_name` from the response with the `200` status
  - added the new `high` enum value to the `effort` response property for the response status `200`
  - added the new `low` enum value to the `effort` response property for the response status `200`
  - added the new `max` enum value to the `effort` response property for the response status `200`
  - added the new `medium` enum value to the `effort` response property for the response status `200`
  - added the new `x-high` enum value to the `effort` response property for the response status `200`
  - api operation id `update_agent_v2_web_search_agents__agent_id__patch` removed and replaced with `update_agent_api_v2_public_web_search_agents__agent_id__patch`
  - api tag `Web Search Agents (public)` added
  - api tag `Web Search Agents` removed
  - added the new optional request property `items/from`
  - added the media type `application/json` to the request body
  - added `#/components/schemas/JsonValue, subschema #2` to the `items/value` request property `anyOf` list
  - the request property `items/value` became optional
  - added the new `add` enum value to the request property `items/op`
  - added the new `copy` enum value to the request property `items/op`
  - added the new `move` enum value to the request property `items/op`
  - added the new `remove` enum value to the request property `items/op`
  - added the new `test` enum value to the request property `items/op`
  - the response property `sources/block/items/order` became required for the status `200`
  - the `allow` response's property default value `` was added for the status `200`
  - the `block` response's property default value `` was added for the status `200`
  - the `order` response's property default value `0` was removed for the status `200`
- **2026-06-18** `2562e655b8f2`: 1 breaking, 4 info
  - the `sources` response's property type changed from `array` to `object` for status `200`
  - added the optional property `sources/allow` to the response with the `200` status
  - added the optional property `sources/avoid` to the response with the `200` status
  - added the optional property `sources/block` to the response with the `200` status
  - added the optional property `sources/prioritize` to the response with the `200` status
- **2026-06-11** `421a9851d61b`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/nimbleway/apis/api-gateway/docs/v1/task-agents/:agent_id/patch.md) - [API](https://skmtc.dev/nimbleway/apis/api-gateway.md) - [Page](https://skmtc.dev/nimbleway/apis/api-gateway/changes/v1/task-agents/:agent_id/patch)