Create suite
Suites
Create Suite
Required scope agent_eval:create. Suites are containers — add cases by setting their suite_id.
POST
Create suite
Suites are containers — create the suite first, then add cases by setting their
suite_id. A suite with no cases can be created but POST /agent-eval/suites/{id}/run returns 400 until at least one case is attached.
Parallelism
parallelism (1-16) is the max number of cases that run concurrently when you trigger the suite. Higher = faster sweeps; lower = nicer to your credit balance if you’re worried about a pricing surprise.
For a regression suite of ~20 cases, parallelism: 4 is a good starting point — finishes in roughly the time of the slowest 5 cases.Authorizations
Your Yappr API key (e.g. ypr_live_...). Generate one in the dashboard under Settings → API Keys.
Body
application/json
Response
Suite created
Curated bundle of eval cases that run as one batch (regression sweep).
Max concurrent cases when the suite runs.
Required range:
1 <= x <= 16Optional default agent for ad-hoc cases added to the suite. Per-case agent_id always wins; this is just a convenience for the dashboard.