v1

latestOpenAPI 3.1.02026-07-2658119246.0 KB

Public API

List Agent Runs

List the runs of an agent, newest first, paginated with offset/limit.

get/v2/agents/{agent_id}/runs

Path parameters

agent_idstring uuid required

Web Search Agent ID, format wsa_<uuid>.

Query parameters

offsetinteger

Number of items to skip before this page.

limitinteger

Maximum number of items to return (1-200).

Response

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.

Example response

{
  "items": [
    {
      "id": "task_run_c0ffee00-0000-4000-8000-000000000000",
      "web_search_agent_id": "wsa_2af5b0e2-58b8-4b60-a1a4-9e57e4d33f00"
    }
  ]
}