Web Search Agents (public)

List Runs

List runs for this instance.

status accepts a lowercase TaskRunStatusValue (e.g. "completed") or a comma-separated list of them (e.g. "queued,running").

get/v1/task-agents/{agent_id}/runs

Request

agent_idstring uuid required

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
  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
- 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 q
- warning
  deleted the query request parameter status
- warning
  removed the optional property // from the response with the status
- info
  api operation id list_runs_api_v2_public_web_search_agents__agent_id__runs_get removed and replaced with list_runs_public_v1_api_v1_public_web_search_agents__agent_id__runs_get
- info
  endpoint deprecated
- info
  added to the // response property anyOf list for the response status
- info
  removed from the // response property anyOf list for the response status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response's property default value 20 was removed for the status
- info
  the response's property default value 0 was removed for the status