Skip to main content
POST
Rerun run

Path Parameters

shortId
string
required

Body

application/json

Request body to rerun a prior run. Provide either failedOnly or projectTestCaseIds, not both (sending both returns 400). Send an empty object to rerun everything.

failedOnly
boolean

Rerun only failed/skipped/errored test cases from the original run.

projectTestCaseIds
string[]

Rerun only these test cases, by project test case ID (UUID).

skipAgentCache
boolean

Set to true to run every test in this run without the agent cache, so the agent works out each step fresh instead of reusing cached outputs. Applies to this run only. Omitted or false keeps each test's own Agent Cache setting.

projectShortId
string

Target a specific project by its prefixed short ID (proj-slug_shortId or proj_shortId), as returned by the projects API. Required for organization-scoped API keys; project-scoped keys may only pass their own project's short ID.

Pattern: ^proj(-.+_.+|_.+)$

Response

200 - application/json

The request has succeeded.

success
boolean
required
run
object
required