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

Query parameters

limitinteger

offsetinteger

filter_use_case'research' | 'enrichment' | 'dataset_building'

filter_effort'low' | 'medium' | 'high' | 'x-high' | 'max'

Canonical effort tier names for the research graph.

workspace_idstring uuid nullable

Successful Response

account_idstring nullable

agent_namestring nullable

created_atstring date-time required

descriptionstring required

display_namestring required

domain_expertisestring required

effort'low' | 'medium' | 'high' | 'x-high' | 'max' required

Canonical effort tier names for the research graph.

iconstring required

idstring required

is_activeboolean required

output_schemaobject nullable required

updated_atstring date-time required

use_case'research' | 'enrichment' | 'dataset_building' required

workspace_idstring uuid nullable