runs

Rerun runs in bulk

Reruns up to 100 runs in one environment, each as a new run of the same agent with its original payload.

Supports two modes:

By IDs: provide run_ids in the request body to rerun specific runs. Query filters are ignored.
By filter: omit run_ids and use the query parameters to match runs.

Deleted runs are skipped. A selection of more than 100 runs returns 422.

Required permission: runs.rerun.

post/v1/projects/{project_id}/runs/bulk-rerun

Request

project_idstring uuid required

ID of the project the API key belongs to.

environment_idstring uuid required

Environment to rerun runs in; only its runs are selected.

deployment_idstring uuid nullable

Only runs executed by this deployment.

start_datestring date-time nullable

Only runs queued at or after this time; applies only together with end_date.

end_datestring date-time nullable

Only runs queued at or before this time; applies only together with start_date.

status_filterRunStatus[] nullable

Only runs in these statuses.

guardrail_outcomestring[] nullable

Only runs with at least one guardrail intervention of these outcomes.

agent_namestring nullable

Only runs of this agent.

test_namestring[] nullable

Filter by A/B test variant names; use base for runs without a variant

exclude_test_runsboolean

Exclude runs with a test name

searchstring nullable

Run search text or filter expression, as in GET /runs.

run_idsstring[] nullable

IDs of the runs to rerun, at most 100. Omit or send null to select runs with the query filters instead; an empty list is rejected.

Successful Response

okboolean required

Whether the operation succeeded.

rerun_countinteger required

Number of runs triggered again.

new_run_idsstring[] required

IDs of the new runs.

No recorded changes to this operation across all 2 revisions of this API.