Web Search Agents (public)

List Agents

List Web Search Agent instances.

Callers are strictly scoped to their (account, workspace). If workspace_id is omitted, the user's default workspace is used.

get/v1/task-agents

Request

offsetinteger

limitinteger

Successful Response

limitinteger required

Maximum number of items returned.

offsetinteger required

Number of items skipped before this page.

totalinteger required

Total number of items matching the query.

Aug 17, 202622c2a2291146 Revision changes
- warning
  deleted the query request parameter workspace_id
- warning
  added the new 5x-high enum value to the // response property for the response status
Jul 20, 2026d4e4f170f4f4 Revision changes
- breaking
  for the query request parameter limit, default value was changed from 20 to 100
- breaking
  the response's body type changed from array to object for status
- warning
  for the query request parameter limit, the max was set to 200.00
- warning
  for the query request parameter limit, the min was set to 1.00
- warning
  for the query request parameter offset, the min was set to 0.00
- warning
  deleted the query request parameter filter_effort
- warning
  deleted the query request parameter filter_use_case
- info
  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
- info
  endpoint deprecated
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status