Skip to main content
POST
Rerun a run's failed cases

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId
string
required

ID of the hosted project that contains the server.

runId
string
required

Eval run ID, as returned by POST /eval-runs.

Body

application/json
scope
enum<string>
required

The only scope: every case with a trial that did not complete and pass.

Available options:
failed_cases
notes
string
idempotencyKey
string
Required string length: 1 - 256

Response

The rerun was started (or, on an idempotent retry, the run it already started).

runId
string
required
suiteId
string
required
status
string
required
rerunOfRunId
string
required
rerunScope
enum<string>
required
Available options:
failed_cases
deduped
boolean
servers
object[]
environment
object · null · null

The project environment a run is pinned to, at the revision resolved when it launched. null for a legacy run that used the suite's saved server selection.