Skip to main content
POST
/
v1
/
agents
/
{agent_id}
/
evolutions
Trigger Evolution
curl --request POST \
  --url https://api.example.com/v1/agents/{agent_id}/evolutions \
  --header 'Content-Type: application/json' \
  --data '
{
  "sample_size": 123,
  "min_improvement_threshold": 123,
  "target_dimensions": [
    "<string>"
  ],
  "max_probes_per_evaluation": 123,
  "probe_concurrency": 123,
  "reflection_model": "<string>",
  "mutation_strategy": "<string>",
  "gepa_max_metric_calls": 123,
  "detection_volume_threshold": 123
}
'
{
  "evolution_id": "<string>",
  "status": "<string>",
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "extra": {}
}

Path Parameters

agent_id
string<uuid>
required

Body

application/json

Optional config overrides for evolution trigger.

sample_size
integer | null
min_improvement_threshold
number | null
target_dimensions
string[] | null
max_probes_per_evaluation
integer | null
probe_concurrency
integer | null
reflection_model
string | null
mutation_strategy
string | null
gepa_max_metric_calls
integer | null
detection_volume_threshold
integer | null

Response

Successful Response

Console-side view of a Darwin evolution job.

evolution_id
string
required
status
string
required
agent_id
string<uuid> | null
team_id
string<uuid> | null
extra
Extra · object
Last modified on April 21, 2026