v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-21149158448.6 KB

Agent Environment

evolution

Trigger Evolution

Trigger evolution for an agent.

Sends the agent's configuration/identifiers to Darwin to start an evolution job. Optional config overrides (sample_size, target_dimensions, etc.) are forwarded to Darwin when provided. Returns 201 Created with a Location header for the new job resource.

post/v1/agents/{agent_id}/evolutions

Path parameters

agent_idstring uuid required

Request body

sample_sizeinteger nullable

min_improvement_thresholdnumber nullable

target_dimensionsstring[] nullable

max_probes_per_evaluationinteger nullable

probe_concurrencyinteger nullable

reflection_modelstring nullable

mutation_strategystring nullable

gepa_max_metric_callsinteger nullable

detection_volume_thresholdinteger nullable

Response

Successful Response

evolution_idstring required

statusstring required

agent_idstring uuid nullable

team_idstring uuid nullable

extraobject