Create Agent

Create a Web Search Agent instance.

account_id is JWT-derived and never read from the request body.

Request body

agent_namestring nullable

descriptionstring nullable

display_namestring nullable

domain_expertisestring nullable

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

Canonical effort tier names for the research graph.

goalsstring[]

iconstring nullable

is_activeboolean

output_schemaobject nullable

suggested_questionsstring[]

templatestring nullable

Template name to materialize this instance from. When set, the scalar fields and child rows are copied from the template.

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

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