Web Search Agents (public)

Get Run

Fetch a run by id, scoped to the instance.

A run resolves only when (run_id, agent_id) match — otherwise 404. This means a stale URL with a swapped agent_id won't leak runs across instances even if the run_id is real.

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

Path parameters

agent_idstring uuid required

run_idstring required

Response

Successful Response

completed_atstring date-time nullable

When the run completed.

created_atstring date-time required

When the run was created.

Canonical effort tier names for the research graph.

idstring required

Run identifier, format "task_run_{uuid}".

interaction_idstring required

Interaction ID.

is_activeboolean required

True while status is 'queued' or 'running'.

promptstring nullable

Prompt submitted for the run.

started_atstring date-time nullable

When the run started executing.

status'queued' | 'running' | 'completed' | 'failed' | 'cancelled' required

Lowercase status values used in API responses (distinct from the DB-level TaskRunStatus enum).

web_search_agent_idstring required

Web Search Agent instance this run belongs to.

Changes

Changed in 5 of the 55 revisions of this API.2716

Aug 17, 202622c2a22911461See the full diff
- ●
  added the new 5x-high enum value to the response property for the response status
  response-property-enum-value-added
This revision also has 104 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 20, 2026d4e4f170f4f414See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ○
  api operation id get_run_api_v2_public_web_search_agents__agent_id__runs__run_id__get removed and replaced with get_run_public_v1_api_v1_public_web_search_agents__agent_id__runs__run_id__get
  api-operation-id-removed
- ○
  endpoint deprecated
  endpoint-deprecated
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed from the response property anyOf list for the response status
  response-property-any-of-removed
This revision also has 36 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 12, 2026e8a97dc9fce21511See the full diff
- ▲
  for the path request parameter agent_id, the format changed from no format to uuid
  request-parameter-type-changed
- ●
  deleted the cookie request parameter token
  request-parameter-removed
- ●
  added the new high enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new low enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new medium enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new x-high enum value to the response property for the response status
  response-property-enum-value-added
- ○
  api operation id get_run_v2_web_search_agents__agent_id__runs__run_id__get removed and replaced with get_run_api_v2_public_web_search_agents__agent_id__runs__run_id__get
  api-operation-id-removed
- ○
  api tag Web Search Agents (public) added
  api-tag-added
- ○
  api tag Web Search Agents removed
  api-tag-removed
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed from the response property anyOf list for the response status
  response-property-any-of-removed
- ○
  the response property became required for the status
  response-property-became-required
- ○
  removed the pro enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the quick enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the quickest enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the research enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  response property web_search_agent_id list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
This revision also has 39 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 7, 2026ebe52c375b711See the full diff
- ▲
  the / response's property format changed from uuid to no format for status
  response-property-type-changed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 10, 2026421a9851d61b1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history