{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Empirical","colors":{"primary":"#000000","light":"#D4D4D4","dark":"#000000"},"logo":{"light":"https://mintcdn.com/empirical/6QELjdPJQ3LR0pOP/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=6QELjdPJQ3LR0pOP\u0026q=85\u0026s=70362d47336d0836bb176c00f9359062","dark":"https://mintcdn.com/empirical/6QELjdPJQ3LR0pOP/logo/wordmark-dark.svg?fit=max\u0026auto=format\u0026n=6QELjdPJQ3LR0pOP\u0026q=85\u0026s=76c038abc85166ca88f23025b50a54f5"},"favicon":"https://mintcdn.com/empirical/WYHhMc-3Yp_VenHe/logo/favicon.svg?fit=max\u0026auto=format\u0026n=WYHhMc-3Yp_VenHe\u0026q=85\u0026s=fbcfc3b86055b3f672438c9f79378fc2","api":{"playground":{}},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#161616"}},"navbar":{"links":[{"href":"https://empirical.run/home","label":"Home"}],"primary":{"type":"button","label":"Dashboard","href":"https://empirical.run/login"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"empirical","hasAudioNarration":false,"actualSubdomain":"empirical","customDomains":["empirical.run"],"gitSource":{"type":"github","owner":"empirical-run","repo":"test-generator","deployBranch":"main","contentDirectory":"external-docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae7531ec01b8679a4af9f2e","collectionId":"3e6efa0a-91bb-4c74-848f-97a6c5de706a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae7531ec01b8679a4af9f2e"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae7531ec01b8679a4af9f2e","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":50},{"language":"default","tag":"Guides","count":25},{"language":"default","tag":"Failure Groups","count":10},{"language":"default","tag":"Features","count":9},{"language":"default","tag":"Test Runs","count":8},{"language":"default","tag":"Snoozes","count":6},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Analytics","count":5},{"language":"default","tag":"Environments","count":5},{"language":"default","tag":"KV","count":5}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n*{border-radius:0!important}::selection{background:#5f5;color:#000}.dark ::selection{background:oklch(.62 .16 328);color:#161616}li[data-active-nav-item=true]>a{background:#000;color:#fff!important;text-shadow:none}li[data-active-nav-item=true]>a *{color:inherit!important}li[data-active-nav-item=true]>a svg{background-color:currentColor!important}.dark li[data-active-nav-item=true]>a{background:#d4d4d4;color:#161616!important}code,kbd,pre{font-family:\"JetBrains Mono\",ui-monospace,monospace!important}.dark #topbar-cta-button a>span{background:#d4d4d4}.dark #topbar-cta-button a :is(span, svg){color:#161616}.dark #navbar div:has(>div>.nav-tabs),.dark #search-bar-entry{background:#1e1e1e}.dark #navbar div:has(>div>.nav-tabs){border-top:1px solid #2f2f2f}"}],"page":{"pagePath":"api-reference/test-runs/re-run-a-test-run","slug":"/api-reference/test-runs/re-run-a-test-run","pageMetadata":{"title":"Re-run a test run","description":"Re-triggers a test run from a source run's branch, build, and overrides. Optionally re-runs only the failed tests of a completed run.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/test-runs/{id}/re-run","href":"/api-reference/test-runs/re-run-a-test-run","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Re-triggers a test run from a source run’s branch, build, and overrides. Optionally re-runs only the failed tests of a completed run.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Re-run a test run","description":"Re-triggers a test run from a source run's branch, build, and overrides. Optionally re-runs only the failed tests of a completed run.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/test-runs/{id}/re-run","href":"/api-reference/test-runs/re-run-a-test-run","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Test Runs"],"operationId":"rerunTestRun","summary":"Re-run a test run","description":"Re-triggers a test run from a source run's branch, build, and overrides. Optionally re-runs only the failed tests of a completed run.","parameters":["f3d1ebf2-ee09-4431-a8fd-342499804fc2"],"requestBody":"12f12735-6a73-4ff7-9fc9-67e36b032584","responses":{"200":"1b2ca998-9309-4a99-b9ef-80d1deb4009c","400":"aa147882-9c07-4f76-911d-439a7be3b982","402":"4f5b49d9-2958-4318-8a1e-41db519ccd46","404":"36f3432a-a6ef-4151-853b-f87925e28ec8"},"method":"post","type":"path","servers":["7f1173af-53ac-4d7c-be61-79db501420f9"],"security":["f04d1695-8406-4e74-b1ce-21eddcd099e5"],"path":"/api/test-runs/{id}/re-run","baseUrlOptions":["https://api.empirical.run"],"title":"Re-run a test run","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f3d1ebf2-ee09-4431-a8fd-342499804fc2":{"schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Test run database ID.","isRequired":true,"uniqueKey":"","typeLabel":"integer"},"required":true,"description":"Test run database ID.","name":"id","in":"path"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"only_failed":{"type":"boolean","description":"When true, re-run only the failed tests from the source run. The source run must be completed.","uniqueKey":"only_failed","typeLabel":"boolean"},"reporters":{"type":"array","items":{"oneOf":[{"type":"object","required":["reporter_type"],"properties":{"reporter_type":{"type":"string","enum":["slack_run_status"],"description":"Posts run status updates to Slack channels.","isRequired":true,"uniqueKey":"reporters.items.[INDEX].oneOf.0.reporter_type","typeLabel":"enum\u003cstring>"},"slack_channels":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"reporters.items.[INDEX].oneOf.0.slack_channels.items.[INDEX]","typeLabel":"string"},"minItems":1,"description":"Slack channel ids (`C…`), as shown in Slack's channel details. Shared (Slack Connect) channels have the same id in every workspace. Each must be a registered, unarchived channel of the project's organization.","uniqueKey":"reporters.items.[INDEX].oneOf.0.slack_channels","typeLabel":"string[]"},"slack_channel_ids":{"type":"array","items":{"type":"integer","minimum":1,"uniqueKey":"reporters.items.[INDEX].oneOf.0.slack_channel_ids.items.[INDEX]","typeLabel":"integer"},"minItems":1,"description":"Registered Slack channel ids from `GET /api/v2/slack/channels` (the numeric `id`). Can be combined with `slack_channels`.","uniqueKey":"reporters.items.[INDEX].oneOf.0.slack_channel_ids","typeLabel":"integer[]"}},"additionalProperties":false,"uniqueKey":"reporters.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["reporter_type"],"properties":{"reporter_type":{"type":"string","enum":["github_check"],"description":"Posts a GitHub check run on the build commit. Needs `build` with a repository the GitHub Reporter app is installed on.","isRequired":true,"uniqueKey":"reporters.items.[INDEX].oneOf.1.reporter_type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"reporters.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["reporter_type"],"properties":{"reporter_type":{"type":"string","enum":["github_pr_comment"],"description":"Posts (and updates) a comment on the pull request for the build branch. Needs `build` with a repository the GitHub Reporter app is installed on.","isRequired":true,"uniqueKey":"reporters.items.[INDEX].oneOf.2.reporter_type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"reporters.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["reporter_type"],"properties":{"reporter_type":{"type":"string","enum":["github_linked_changes"],"description":"Tracks the test branch named after the head branch of the app pull request the run was triggered for (`trigger.event` `pull_request`), and keeps the `Empirical linked test changes` check on that pull request up to date: it passes when the test branch has nothing left to merge and fails while it has unmerged commits. The pull request's latest run decides whether it is tracked. Does nothing for runs not triggered by a pull request. Needs `build` with a repository the GitHub Reporter app is installed on.","isRequired":true,"uniqueKey":"reporters.items.[INDEX].oneOf.3.reporter_type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"reporters.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["reporter_type"],"properties":{"reporter_type":{"type":"string","enum":["email_run_report"],"description":"Emails a report when the run ends to every user whose email domain is one of the organization's email domains.","isRequired":true,"uniqueKey":"reporters.items.[INDEX].oneOf.4.reporter_type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"reporters.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["reporter_type"],"properties":{"reporter_type":{"type":"string","enum":["slack_creator_dm"],"description":"Sends a Slack DM to whoever started the run (from the dashboard, the CLI or an agent session) when it ends, if their Slack account is linked. Runs triggered with a project API key have no one to DM.","isRequired":true,"uniqueKey":"reporters.items.[INDEX].oneOf.5.reporter_type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"reporters.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"reporters.items.[INDEX]","typeLabel":"object"},"description":"Reporters for the re-run, in the same shape as on trigger. Defaults to the source run's reporters.","uniqueKey":"reporters","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"only_failed":true,"reporters":[{"reporter_type":"slack_run_status","slack_channels":["\u003cstring>"],"slack_channel_ids":[2]}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1b2ca998-9309-4a99-b9ef-80d1deb4009c":{"description":"The re-triggered test run.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"trigger":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the test run was triggered successfully.","isRequired":true,"uniqueKey":"data.trigger.success","typeLabel":"boolean"}},"required":["success"],"isRequired":true,"uniqueKey":"data.trigger","typeLabel":"object"},"test_run":{"type":"object","properties":{"id":{"type":"number","description":"Unique identifier for the test run.","isRequired":true,"uniqueKey":"data.test_run.id","typeLabel":"number"},"state":{"type":"string","description":"Current state of the test run.","isRequired":true,"uniqueKey":"data.test_run.state","typeLabel":"string"},"error_code":{"oneOf":[{"type":"string","description":"Normalized error code when branch resolution or execution failed.","isRequired":true,"uniqueKey":"data.test_run.error_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Normalized error code when branch resolution or execution failed.","isRequired":true,"uniqueKey":"data.test_run.error_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.error_code","typeLabel":"string | null"},"test_run_branch":{"type":"string","description":"Git branch being tested.","isRequired":true,"uniqueKey":"data.test_run.test_run_branch","typeLabel":"string"},"created_at":{"type":"string","description":"ISO 8601 timestamp when the run was created.","isRequired":true,"uniqueKey":"data.test_run.created_at","typeLabel":"string"},"concurrency":{"oneOf":[{"type":"object","properties":{"group":{"type":"string","description":"Concurrency group the run was scoped to. Runs in the same group are limited to one in progress at a time.","isRequired":true,"uniqueKey":"data.test_run.concurrency.oneOf.0.group","typeLabel":"string"},"on_conflict":{"type":"string","enum":["cancel","wait"],"description":"What this run did when the group already had an active run: `cancel` cancelled it, `wait` queued behind it.","isRequired":true,"uniqueKey":"data.test_run.concurrency.oneOf.0.on_conflict","typeLabel":"enum\u003cstring>"}},"required":["group","on_conflict"],"description":"Concurrency group and policy the run was created with, or null when no limit applied.","isRequired":true,"uniqueKey":"data.test_run.concurrency.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"group":{"type":"string","description":"Concurrency group the run was scoped to. Runs in the same group are limited to one in progress at a time."},"on_conflict":{"type":"string","enum":["cancel","wait"],"description":"What this run did when the group already had an active run: `cancel` cancelled it, `wait` queued behind it."}},"required":["group","on_conflict"],"description":"Concurrency group and policy the run was created with, or null when no limit applied.","isRequired":true,"uniqueKey":"data.test_run.concurrency.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.concurrency","typeLabel":"object | null"},"test_code":{"oneOf":[{"type":"object","properties":{"requested":{"type":"object","properties":{"branch":{"type":"string","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.requested.branch","typeLabel":"string"},"source":{"type":"string","enum":["explicit","build","project_default","legacy"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.requested.source","typeLabel":"enum\u003cstring>"},"if_missing":{"type":"string","enum":["error","use_default","create"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.requested.if_missing","typeLabel":"enum\u003cstring>"}},"required":["branch","source","if_missing"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.requested","typeLabel":"object"},"resolved":{"type":"object","properties":{"branch":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved.branch.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved.branch.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved.branch","typeLabel":"string | null"},"sha":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved.sha.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved.sha.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved.sha","typeLabel":"string | null"},"fallback_reason":{"oneOf":[{"type":"string","enum":["requested_branch_missing"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved.fallback_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["requested_branch_missing"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved.fallback_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved.fallback_reason","typeLabel":"enum\u003cstring> | null"}},"required":["branch","sha","fallback_reason"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolved","typeLabel":"object"},"execution":{"type":"object","properties":{"ref":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution.ref.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution.ref.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution.ref","typeLabel":"string | null"},"sha":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution.sha.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution.sha.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution.sha","typeLabel":"string | null"},"ref_kind":{"oneOf":[{"type":"string","enum":["branch","temporary_merge"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution.ref_kind.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["branch","temporary_merge"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution.ref_kind.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution.ref_kind","typeLabel":"enum\u003cstring> | null"}},"required":["ref","sha","ref_kind"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.execution","typeLabel":"object"},"merge_base":{"oneOf":[{"type":"object","properties":{"branch":{"type":"string","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.merge_base.oneOf.0.branch","typeLabel":"string"},"sha":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.merge_base.oneOf.0.sha.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.merge_base.oneOf.0.sha.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.merge_base.oneOf.0.sha","typeLabel":"string | null"}},"required":["branch","sha"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.merge_base.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"branch":{"type":"string"},"sha":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["branch","sha"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.merge_base.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.merge_base","typeLabel":"object | null"},"resolution_status":{"type":"string","enum":["pending","resolved","branch_missing","merge_conflict","provider_error"],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolution_status","typeLabel":"enum\u003cstring>"},"resolution_error_code":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolution_error_code.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolution_error_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0.resolution_error_code","typeLabel":"string | null"}},"required":["requested","resolved","execution","merge_base","resolution_status","resolution_error_code"],"description":"Requested, resolved, and executed test-repository code.","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"requested":{"type":"object","properties":{"branch":{"type":"string"},"source":{"type":"string","enum":["explicit","build","project_default","legacy"]},"if_missing":{"type":"string","enum":["error","use_default","create"]}},"required":["branch","source","if_missing"]},"resolved":{"type":"object","properties":{"branch":{"oneOf":[{"type":"string"},{"type":"null"}]},"sha":{"oneOf":[{"type":"string"},{"type":"null"}]},"fallback_reason":{"oneOf":[{"type":"string","enum":["requested_branch_missing"]},{"type":"null","enum":["requested_branch_missing"]}]}},"required":["branch","sha","fallback_reason"]},"execution":{"type":"object","properties":{"ref":{"oneOf":[{"type":"string"},{"type":"null"}]},"sha":{"oneOf":[{"type":"string"},{"type":"null"}]},"ref_kind":{"oneOf":[{"type":"string","enum":["branch","temporary_merge"]},{"type":"null","enum":["branch","temporary_merge"]}]}},"required":["ref","sha","ref_kind"]},"merge_base":{"oneOf":[{"type":"object","properties":{"branch":{"type":"string"},"sha":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["branch","sha"]},{"type":"null","properties":{"branch":{"type":"string"},"sha":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["branch","sha"]}]},"resolution_status":{"type":"string","enum":["pending","resolved","branch_missing","merge_conflict","provider_error"]},"resolution_error_code":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["requested","resolved","execution","merge_base","resolution_status","resolution_error_code"],"description":"Requested, resolved, and executed test-repository code.","isRequired":true,"uniqueKey":"data.test_run.test_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.test_code","typeLabel":"object | null"},"trigger":{"oneOf":[{"type":"object","properties":{"event":{"type":"string","enum":["pull_request"],"description":"Event that produced the run.","isRequired":true,"uniqueKey":"data.test_run.trigger.oneOf.0.event","typeLabel":"enum\u003cstring>"},"pull_request":{"type":"object","properties":{"head":{"type":"string","minLength":1,"description":"Head branch.","isRequired":true,"uniqueKey":"data.test_run.trigger.oneOf.0.pull_request.head","typeLabel":"string"},"base":{"type":"string","minLength":1,"description":"Base branch.","isRequired":true,"uniqueKey":"data.test_run.trigger.oneOf.0.pull_request.base","typeLabel":"string"},"number":{"type":"integer","minimum":1,"description":"Pull request number in the application repository.","uniqueKey":"data.test_run.trigger.oneOf.0.pull_request.number","typeLabel":"integer"}},"required":["head","base"],"additionalProperties":false,"description":"Pull request under test.","isRequired":true,"uniqueKey":"data.test_run.trigger.oneOf.0.pull_request","typeLabel":"object"}},"required":["event","pull_request"],"additionalProperties":false,"description":"The `trigger` the run was created with, or null when none was sent.","isRequired":true,"uniqueKey":"data.test_run.trigger.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"event":{"type":"string","enum":["pull_request"],"description":"Event that produced the run."},"pull_request":{"type":"object","properties":{"number":{"type":"integer","minimum":1,"description":"Pull request number in the application repository."},"head":{"type":"string","minLength":1,"description":"Head branch."},"base":{"type":"string","minLength":1,"description":"Base branch."}},"required":["head","base"],"additionalProperties":false,"description":"Pull request under test."}},"required":["event","pull_request"],"additionalProperties":false,"description":"The `trigger` the run was created with, or null when none was sent.","isRequired":true,"uniqueKey":"data.test_run.trigger.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.test_run.trigger","typeLabel":"object | null"}},"required":["id","state","error_code","test_run_branch","created_at","concurrency","test_code","trigger"],"isRequired":true,"uniqueKey":"data.test_run","typeLabel":"object"}},"required":["trigger","test_run"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"trigger":{"success":true},"test_run":{"id":123,"state":"\u003cstring>","error_code":"\u003cstring>","test_run_branch":"\u003cstring>","created_at":"\u003cstring>","concurrency":{"group":"\u003cstring>","on_conflict":"cancel"},"test_code":{"requested":{"branch":"\u003cstring>","source":"explicit","if_missing":"error"},"resolved":{"branch":"\u003cstring>","sha":"\u003cstring>","fallback_reason":"requested_branch_missing"},"execution":{"ref":"\u003cstring>","sha":"\u003cstring>","ref_kind":"branch"},"merge_base":{"branch":"\u003cstring>","sha":"\u003cstring>"},"resolution_status":"pending","resolution_error_code":"\u003cstring>"},"trigger":{"event":"pull_request","pull_request":{"head":"\u003cstring>","base":"\u003cstring>","number":2}}}}}}},"exampleType":"generated"}},"exampleType":"generated"},"aa147882-9c07-4f76-911d-439a7be3b982":{"description":"Invalid request.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"description":"Always null for error responses.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"},"error":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"description":"Error details.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["data","error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":"\u003cunknown>","error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"4f5b49d9-2958-4318-8a1e-41db519ccd46":{"description":"Billing blocked: an overdue invoice, a failed renewal, no active plan, or the spend limit reached.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"description":"Always null for error responses.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"},"error":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"description":"Error details.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["data","error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":"\u003cunknown>","error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"36f3432a-a6ef-4151-853b-f87925e28ec8":{"description":"Source test run or environment not found.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"description":"Always null for error responses.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"},"error":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"description":"Error details.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["data","error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":"\u003cunknown>","error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f04d1695-8406-4e74-b1ce-21eddcd099e5":{"Bearer":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"Bearer"}}},"servers":{"7f1173af-53ac-4d7c-be61-79db501420f9":{"url":"https://api.empirical.run"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"api-reference/openapi.generated.json"},"subdomain":"empirical","siteName":"Empirical","title":"Re-run a test run - Empirical","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-31T08:27:11.027Z","originalFileLocation":"api-reference/test-runs/re-run-a-test-run.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Re-triggers a test run from a source run\u0026#x27;s branch, build, and overrides. Optionally re-runs only the failed tests of a completed run.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Empirical\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Re-run a test run - Empirical\">\u003cmeta data-mint-head property=\"og:description\" content=\"Re-triggers a test run from a source run\u0026#x27;s branch, build, and overrides. Optionally re-runs only the failed tests of a completed run.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Empirical\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://empirical.mintlify.app/_mintlify/api/og/v2?division=Test+Runs\u0026amp;title=Re-run+a+test+run\u0026amp;description=Re-triggers+a+test+run+from+a+source+run%27s+branch%2C+build%2C+and+overrides.+Optionally+re-runs+only+the+failed+tests+of+a+completed+run.\u0026amp;theme=f70f53f39fe8b87f817734d5\u0026amp;signature=0ac228fc690fefac6069a7810a075f67b1e9b8bc320eecb4c5af937daefa627d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Re-run a test run - Empirical\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Re-triggers a test run from a source run\u0026#x27;s branch, build, and overrides. Optionally re-runs only the failed tests of a completed run.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://empirical.mintlify.app/_mintlify/api/og/v2?division=Test+Runs\u0026amp;title=Re-run+a+test+run\u0026amp;description=Re-triggers+a+test+run+from+a+source+run%27s+branch%2C+build%2C+and+overrides.+Optionally+re-runs+only+the+failed+tests+of+a+completed+run.\u0026amp;theme=f70f53f39fe8b87f817734d5\u0026amp;signature=0ac228fc690fefac6069a7810a075f67b1e9b8bc320eecb4c5af937daefa627d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Empirical\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/test-runs/re-run-a-test-run.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://empirical.run/#organization\",\"name\":\"Empirical\",\"url\":\"https://empirical.run\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/empirical/6QELjdPJQ3LR0pOP/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=6QELjdPJQ3LR0pOP\u0026q=85\u0026s=70362d47336d0836bb176c00f9359062\"}},{\"@type\":\"WebSite\",\"@id\":\"https://empirical.run/docs#website\",\"name\":\"Empirical\",\"url\":\"https://empirical.run/docs\",\"publisher\":{\"@id\":\"https://empirical.run/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run#webpage\",\"url\":\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run\",\"name\":\"Re-run a test run\",\"description\":\"Re-triggers a test run from a source run's branch, build, and overrides. Optionally re-runs only the failed tests of a completed run.\",\"dateModified\":\"2026-10-31T08:27:11.027Z\",\"isPartOf\":{\"@id\":\"https://empirical.run/docs#website\"},\"breadcrumb\":{\"@id\":\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Test Runs\",\"item\":\"https://empirical.run/docs/api-reference/test-runs/list-test-runs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Re-run a test run\",\"item\":\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run#apireference\",\"headline\":\"Re-run a test run\",\"name\":\"Re-run a test run\",\"description\":\"Re-triggers a test run from a source run's branch, build, and overrides. Optionally re-runs only the failed tests of a completed run.\",\"url\":\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run\",\"mainEntityOfPage\":{\"@id\":\"https://empirical.run/docs/api-reference/test-runs/re-run-a-test-run#webpage\"},\"dateModified\":\"2026-10-31T08:27:11.027Z\",\"publisher\":{\"@id\":\"https://empirical.run/#organization\"},\"isPartOf\":{\"@id\":\"https://empirical.run/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Empirical\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Empirical","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Test Runs","pages":[{"title":"List test runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/test-runs","href":"/api-reference/test-runs/list-test-runs"},{"title":"Trigger a test run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json put /api/test-runs","href":"/api-reference/test-runs/trigger-a-test-run"},{"title":"Get a test run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/test-runs/{id}","href":"/api-reference/test-runs/get-a-test-run"},{"title":"List test run artifacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/test-runs/{id}/artifacts","href":"/api-reference/test-runs/list-test-run-artifacts"},{"title":"Cancel a test run","description":"Cancels an in-progress test run, recording an optional reason and the cancelling user. Returns 412 when the run is already in a terminal state.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/test-runs/{id}/cancel","href":"/api-reference/test-runs/cancel-a-test-run"},{"title":"Re-run a test run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/test-runs/{id}/re-run","href":"/api-reference/test-runs/re-run-a-test-run"},{"title":"Skip a test run","description":"Marks the Empirical check run on a commit as skipped. Callers authenticate with a project API key.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/v1/test-runs/skip","href":"/api-reference/test-runs/skip-a-test-run"},{"title":"Get test run metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/test-runs/{id}","href":"/api-reference/test-runs/get-test-run-metadata"}]},{"group":"Test Cases","pages":[{"title":"List test cases","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/test-cases","href":"/api-reference/test-cases/list-test-cases"},{"title":"Get a test case","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/test-cases/{id}","href":"/api-reference/test-cases/get-a-test-case"},{"title":"Update test case tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/v2/test-cases/{id}","href":"/api-reference/test-cases/update-test-case-tags"},{"title":"List test case tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/test-cases/tags","href":"/api-reference/test-cases/list-test-case-tags"}]},{"group":"Environments","pages":[{"title":"Create an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/environments","href":"/api-reference/environments/create-an-environment"},{"title":"Delete an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json delete /api/environments/{id}","href":"/api-reference/environments/delete-an-environment"},{"title":"Update an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/environments/{id}","href":"/api-reference/environments/update-an-environment"},{"title":"List environments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/environments/list","href":"/api-reference/environments/list-environments"},{"title":"Sync environments from YAML","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/environments/sync","href":"/api-reference/environments/sync-environments-from-yaml"}]},{"group":"Snoozes","pages":[{"title":"List snoozes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/snoozes","href":"/api-reference/snoozes/list-snoozes"},{"title":"Create a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/snoozes","href":"/api-reference/snoozes/create-a-snooze"},{"title":"Get a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/snoozes/{id}","href":"/api-reference/snoozes/get-a-snooze"},{"title":"Delete a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json delete /api/snoozes/{id}","href":"/api-reference/snoozes/delete-a-snooze"},{"title":"Update a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/snoozes/{id}","href":"/api-reference/snoozes/update-a-snooze"},{"title":"Add tests to a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/snoozes/{id}/add-test-cases","href":"/api-reference/snoozes/add-tests-to-a-snooze"}]},{"group":"KV","pages":[{"title":"List KV entries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/kv","href":"/api-reference/kv/list-kv-entries"},{"title":"Get a KV entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/kv/{key}","href":"/api-reference/kv/get-a-kv-entry"},{"title":"Write a KV entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json put /api/kv/{key}","href":"/api-reference/kv/write-a-kv-entry"},{"title":"Delete a KV entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json delete /api/kv/{key}","href":"/api-reference/kv/delete-a-kv-entry"},{"title":"Refresh a KV entry's TTL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/kv/{key}","href":"/api-reference/kv/refresh-a-kv-entrys-ttl"}]},{"group":"Analytics","pages":[{"title":"Test-case execution history (batch)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/v2/analytics/test-case-history/batch","href":"/api-reference/analytics/test-case-execution-history-batch"},{"title":"Last passing run per environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/v2/analytics/test-case-last-pass-per-env","href":"/api-reference/analytics/last-passing-run-per-environment"},{"title":"Test-case analytics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/analytics/test-cases","href":"/api-reference/analytics/test-case-analytics"},{"title":"Test-count analytics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/analytics/test-count","href":"/api-reference/analytics/test-count-analytics"},{"title":"Test-run analytics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/analytics/test-runs","href":"/api-reference/analytics/test-run-analytics"}]},{"group":"Badges","pages":[{"title":"Get an environment status badge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/badges/projects/{project_slug}/environments/{environment_slug}","href":"/api-reference/badges/get-an-environment-status-badge"}]},{"group":"Failure Groups","pages":[{"title":"List failure groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups","href":"/api-reference/failure-groups/list-failure-groups"},{"title":"Create a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/failure-groups","href":"/api-reference/failure-groups/create-a-failure-group"},{"title":"Get a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups/{id}","href":"/api-reference/failure-groups/get-a-failure-group"},{"title":"Delete a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json delete /api/failure-groups/{id}","href":"/api-reference/failure-groups/delete-a-failure-group"},{"title":"Update a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/failure-groups/{id}","href":"/api-reference/failure-groups/update-a-failure-group"},{"title":"Get a failure group's activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups/{id}/activity","href":"/api-reference/failure-groups/get-a-failure-groups-activity"},{"title":"List a failure group's members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups/{id}/members","href":"/api-reference/failure-groups/list-a-failure-groups-members"},{"title":"Attach a failing test to a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/failure-groups/{id}/members","href":"/api-reference/failure-groups/attach-a-failing-test-to-a-failure-group"},{"title":"Merge a failure group into another","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/failure-groups/{id}/merge","href":"/api-reference/failure-groups/merge-a-failure-group-into-another"},{"title":"List a run's failure-group members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups/members","href":"/api-reference/failure-groups/list-a-runs-failure-group-members"}]},{"group":"Files","pages":[{"title":"List files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/files","href":"/api-reference/files/list-files"},{"title":"Create a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/files","href":"/api-reference/files/create-a-file"},{"title":"Get a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/files/{id}","href":"/api-reference/files/get-a-file"},{"title":"Confirm a file upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/files/{id}","href":"/api-reference/files/confirm-a-file-upload"}]},{"group":"Reporter Configuration","pages":[{"title":"List reporters","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/reporters","href":"/api-reference/reporter-configuration/list-reporters"}]}]}]},"basePath":"","title":"Re-run a test run - Empirical","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CLz2_Z5D.js","utils-7A5jZhOT.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BVWmkKuv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-4SOfrh0F.js","snippetPresets-CMc8KicP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-DeQN5MDd.js","ApiExamples-Ba9tX7z3.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Be8krXvv.js","shallow-CBC3K1uB.js","getApiPlaygroundDisplay-4tKcUAYo.js","CodeSnippet-C1Xa06ft.js","CodeSnippets-vqiz27A_.js","getPastedJson-NUwRfM32.js","icon-DkIVqWh9.js","MethodPill-qmhT7_wz.js","DuplicateIcon-_gWp1vhn.js","createIcon-NA1p_TVA.js","DynamicMarkdown-Bas9A7wq.js","SectionHeading-a1cS-24U.js","axios-vUo_bRtp.js","Markdown-D3ZTwq_a.js","clsx-BcghKhHb.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B66mVNPp.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DmooSyTN.js"]}