---
title: "Changes to List Agents"
method: GET
path: "/v1/task-agents"
---

# Changes to List Agents

`GET /v1/task-agents`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 56 revisions.

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

## Changes

- **2026-08-17** `22c2a2291146`: 2 warning
  - deleted the `query` request parameter `workspace_id`
  - added the new `5x-high` enum value to the `items/items/effort` response property for the response status `200`
- **2026-07-20** `d4e4f170f4f4`: 2 breaking, 5 warning, 6 info
  - for the `query` request parameter `limit`, default value was changed from `20` to `100`
  - the response's body type changed from `array` to `object` for status `200`
  - for the `query` request parameter `limit`, the max was set to `200.00`
  - for the `query` request parameter `limit`, the min was set to `1.00`
  - for the `query` request parameter `offset`, the min was set to `0.00`
  - deleted the `query` request parameter `filter_effort`
  - deleted the `query` request parameter `filter_use_case`
  - api operation id `list_agents_api_v2_public_web_search_agents_get` removed and replaced with `list_agents_public_v1_api_v1_public_web_search_agents_get`
  - endpoint deprecated
  - added the required property `items` to the response with the `200` status
  - added the required property `limit` to the response with the `200` status
  - added the required property `offset` to the response with the `200` status
  - added the required property `total` to the response with the `200` status
- **2026-07-13** `e8a97dc9fce2`: 9 warning, 12 info
  - deleted the `cookie` request parameter `token`
  - deleted the `query` request parameter `effort`
  - deleted the `query` request parameter `use_case`
  - removed the optional property `items/workspace_name` from the response with the `200` status
  - added the new `high` enum value to the `items/effort` response property for the response status `200`
  - added the new `low` enum value to the `items/effort` response property for the response status `200`
  - added the new `max` enum value to the `items/effort` response property for the response status `200`
  - added the new `medium` enum value to the `items/effort` response property for the response status `200`
  - added the new `x-high` enum value to the `items/effort` response property for the response status `200`
  - api operation id `list_agents_v2_web_search_agents_get` removed and replaced with `list_agents_api_v2_public_web_search_agents_get`
  - the endpoint scheme security `APIKeyCookie` was added to the API
  - the endpoint scheme security `HTTPBearer` was added to the API
  - api tag `Web Search Agents (public)` added
  - api tag `Web Search Agents` removed
  - added the new optional `query` request parameter `filter_effort`
  - added the new optional `query` request parameter `filter_use_case`
  - added the new optional `query` request parameter `workspace_id`
  - the response property `items/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 `items/sources` response's property type changed from `array` to `object` for status `200`
  - added the optional property `items/sources/allow` to the response with the `200` status
  - added the optional property `items/sources/avoid` to the response with the `200` status
  - added the optional property `items/sources/block` to the response with the `200` status
  - added the optional property `items/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/get.md) - [API](https://skmtc.dev/nimbleway/apis/api-gateway.md) - [Page](https://skmtc.dev/nimbleway/apis/api-gateway/changes/v1/task-agents/get)