Launches tests of one of your agents and returns the execution immediately. Give testIds to launch a selection, or omit it to launch every test of the agent; repetitions (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.
Runs created per test, between 1 and 5; null means 1
Response
Success
One launch: the group of runs created together for a list of tests, each repeated repetitions times. Status, counters, tests, startedAt and finishedAt are derived from the runs.
Per test, in testIds order: runs per status and pass rate over the repetitions
Show child attributes
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Starleads api docs","colors":{"primary":"#FF5B22","light":"#fe8c74","dark":"#FF5B22"},"favicon":"https://mintcdn.com/locuta/tZlUd6iyAfQwa0YL/logo/favicon.svg?fit=max\u0026auto=format\u0026n=tZlUd6iyAfQwa0YL\u0026q=85\u0026s=967e53c47421a4ed3c5adccac9a32e37","logo":{"light":"https://mintcdn.com/locuta/nbODknSPetkh4479/logo/logo-light.png?fit=max\u0026auto=format\u0026n=nbODknSPetkh4479\u0026q=85\u0026s=0c3dc57cc8eb4727a18bea5b413cfc61","dark":"https://mintcdn.com/locuta/nbODknSPetkh4479/logo/logo-dark.png?fit=max\u0026auto=format\u0026n=nbODknSPetkh4479\u0026q=85\u0026s=b9a5ae7998f0db400ea8722f90609ed5"},"api":{"openapi":"api-reference/openapi.json","mdx":{"server":"https://api.starleads.co","auth":{"method":"key","name":"X-Api-Key"}}},"navbar":{"primary":{"type":"button","label":"Log in","href":"https://app.starleads.co"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/starleads-co","website":"https://starleads.co"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"locuta","hasAudioNarration":false,"actualSubdomain":"locuta","customDomains":["docs.starleads.co"],"gitSource":{"type":"github","owner":"locuta","repo":"starleads-public-gateway","deployBranch":"mintifly","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab11ae5ebb61b9bf7312a43","collectionId":"4cf50806-03bb-46b2-9027-a2d8bbba048f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab11ae5ebb61b9bf7312a43"},"entitlements":{},"buildId":"6ab11ae5ebb61b9bf7312a43","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Agents","count":10},{"language":"default","tag":"Agent Tests","count":8},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Campaign Items","count":7},{"language":"default","tag":"Knowledge Base — Documents","count":7},{"language":"default","tag":"Agent Test Folders","count":5},{"language":"default","tag":"Knowledge Base — Datasets","count":5},{"language":"default","tag":"Knowledge Base — Chats","count":5},{"language":"default","tag":"Knowledge Base — Knowledge Graph","count":5}]},"assistantConfig":{},"basePath":"","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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/agenttestexecution/launch-tests","slug":"/api-reference/agenttestexecution/launch-tests","pageMetadata":{"title":"Launch tests","openapi":"POST /AgentTestExecution","description":"Launches tests of one of your agents and returns the execution immediately. Give `testIds` to launch a selection, or omit it to launch every test of the agent; `repetitions` (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.","href":"/api-reference/agenttestexecution/launch-tests"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Launches tests of one of your agents and returns the execution immediately. Give \", _jsx(_components.code, {\n children: \"testIds\"\n }), \" to launch a selection, or omit it to launch every test of the agent; \", _jsx(_components.code, {\n children: \"repetitions\"\n }), \" (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.\"]\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":"Launch tests","openapi":"POST /AgentTestExecution","description":"Launches tests of one of your agents and returns the execution immediately. Give `testIds` to launch a selection, or omit it to launch every test of the agent; `repetitions` (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.","href":"/api-reference/agenttestexecution/launch-tests"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["AgentTestExecution"],"summary":"Launch tests","description":"Launches tests of one of your agents and returns the execution immediately. Give `testIds` to launch a selection, or omit it to launch every test of the agent; `repetitions` (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.","operationId":"CreateAgentTestExecution","parameters":["29ae547e-449f-4b07-8400-00829dddd0c0"],"requestBody":"1306355d-93c9-48a6-bf77-ddaf6b24266c","responses":{"200":"76d4b91b-d8db-4d52-bff0-f768cc7ec86a","401":"c36fbc23-89a6-4852-be87-f8eec31323bf","404":"8192fbc3-1d65-4f55-907b-8d85d08092b0","422":"6d051e3a-5856-4c9e-8cb1-21d6bacdba77"},"method":"post","type":"path","servers":[],"security":[],"path":"/AgentTestExecution","baseUrlOptions":["https://api.starleads.co"],"title":"Launch tests","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"29ae547e-449f-4b07-8400-00829dddd0c0":{"name":"X-Api-Key","in":"header","description":"Api key to pass as a ```X-Api-Key``` request header.","required":true,"schema":{"type":"string","isRequired":true,"description":"Api key to pass as a ```X-Api-Key``` request header.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"required":["agentId"],"type":"object","properties":{"agentId":{"minLength":1,"type":"string","description":"Agent owning the tests","isRequired":true,"uniqueKey":"agentId","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"Free text naming the launch; defaults to \"{n} tests\"","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free text naming the launch; defaults to \"{n} tests\"","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"testIds":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"testIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Tests of the agent to launch; absent or empty launches every test of the agent","uniqueKey":"testIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Tests of the agent to launch; absent or empty launches every test of the agent","uniqueKey":"testIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"testIds","typeLabel":"string[] | null"},"repetitions":{"oneOf":[{"type":"integer","description":"Runs created per test, between 1 and 5; null means 1","format":"int32","uniqueKey":"repetitions.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Runs created per test, between 1 and 5; null means 1","format":"int32","uniqueKey":"repetitions.oneOf.1","typeLabel":"null"}],"uniqueKey":"repetitions","typeLabel":"integer\u003cint32> | null"}},"additionalProperties":false,"description":"Tests to launch. Omit testIds (or leave it empty) to launch every test of the agent.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"agentId":"\u003cstring>","name":"\u003cstring>","testIds":["\u003cstring>"],"repetitions":123}}},"exampleType":"generated"},"text/json":{"schema":{"required":["agentId"],"type":"object","properties":{"agentId":{"minLength":1,"type":"string","description":"Agent owning the tests","isRequired":true,"uniqueKey":"agentId","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"Free text naming the launch; defaults to \"{n} tests\"","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free text naming the launch; defaults to \"{n} tests\"","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"testIds":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"testIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Tests of the agent to launch; absent or empty launches every test of the agent","uniqueKey":"testIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Tests of the agent to launch; absent or empty launches every test of the agent","uniqueKey":"testIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"testIds","typeLabel":"string[] | null"},"repetitions":{"oneOf":[{"type":"integer","description":"Runs created per test, between 1 and 5; null means 1","format":"int32","uniqueKey":"repetitions.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Runs created per test, between 1 and 5; null means 1","format":"int32","uniqueKey":"repetitions.oneOf.1","typeLabel":"null"}],"uniqueKey":"repetitions","typeLabel":"integer\u003cint32> | null"}},"additionalProperties":false,"description":"Tests to launch. Omit testIds (or leave it empty) to launch every test of the agent.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"agentId":"\u003cstring>","name":"\u003cstring>","testIds":["\u003cstring>"],"repetitions":123}}},"exampleType":"generated"},"application/*+json":{"schema":{"required":["agentId"],"type":"object","properties":{"agentId":{"minLength":1,"type":"string","description":"Agent owning the tests","isRequired":true,"uniqueKey":"agentId","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"Free text naming the launch; defaults to \"{n} tests\"","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free text naming the launch; defaults to \"{n} tests\"","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"testIds":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"testIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Tests of the agent to launch; absent or empty launches every test of the agent","uniqueKey":"testIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Tests of the agent to launch; absent or empty launches every test of the agent","uniqueKey":"testIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"testIds","typeLabel":"string[] | null"},"repetitions":{"oneOf":[{"type":"integer","description":"Runs created per test, between 1 and 5; null means 1","format":"int32","uniqueKey":"repetitions.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Runs created per test, between 1 and 5; null means 1","format":"int32","uniqueKey":"repetitions.oneOf.1","typeLabel":"null"}],"uniqueKey":"repetitions","typeLabel":"integer\u003cint32> | null"}},"additionalProperties":false,"description":"Tests to launch. Omit testIds (or leave it empty) to launch every test of the agent.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"agentId":"\u003cstring>","name":"\u003cstring>","testIds":["\u003cstring>"],"repetitions":123}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"76d4b91b-d8db-4d52-bff0-f768cc7ec86a":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","uniqueKey":"id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"id.oneOf.1","typeLabel":"null"}],"uniqueKey":"id","typeLabel":"string | null"},"agentId":{"oneOf":[{"type":"string","uniqueKey":"agentId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"agentId.oneOf.1","typeLabel":"null"}],"uniqueKey":"agentId","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"Free text given at launch (\"all tests\", \"folder X\", ...); defaults to \"{n} tests\"","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free text given at launch (\"all tests\", \"folder X\", ...); defaults to \"{n} tests\"","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"repetitions":{"type":"integer","description":"Runs created per test (1-5)","format":"int32","uniqueKey":"repetitions","typeLabel":"integer\u003cint32>"},"testIds":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"testIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Distinct tests launched, in launch order","uniqueKey":"testIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Distinct tests launched, in launch order","uniqueKey":"testIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"testIds","typeLabel":"string[] | null"},"status":{"enum":["Queued","Running","Completed","Cancelled"],"type":"string","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"startedAt":{"oneOf":[{"type":"string","description":"First run dispatched","format":"date-time","uniqueKey":"startedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"First run dispatched","format":"date-time","uniqueKey":"startedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"startedAt","typeLabel":"string\u003cdate-time> | null"},"finishedAt":{"oneOf":[{"type":"string","description":"Last run finished, set once every run is terminal","format":"date-time","uniqueKey":"finishedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Last run finished, set once every run is terminal","format":"date-time","uniqueKey":"finishedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"finishedAt","typeLabel":"string\u003cdate-time> | null"},"cancelledAt":{"oneOf":[{"type":"string","description":"Set when the execution was cancelled","format":"date-time","uniqueKey":"cancelledAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Set when the execution was cancelled","format":"date-time","uniqueKey":"cancelledAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"cancelledAt","typeLabel":"string\u003cdate-time> | null"},"counters":{"type":"object","properties":{"total":{"type":"integer","format":"int32","uniqueKey":"counters.total","typeLabel":"integer\u003cint32>"},"queued":{"type":"integer","format":"int32","uniqueKey":"counters.queued","typeLabel":"integer\u003cint32>"},"running":{"type":"integer","format":"int32","uniqueKey":"counters.running","typeLabel":"integer\u003cint32>"},"passed":{"type":"integer","format":"int32","uniqueKey":"counters.passed","typeLabel":"integer\u003cint32>"},"failed":{"type":"integer","format":"int32","uniqueKey":"counters.failed","typeLabel":"integer\u003cint32>"},"error":{"type":"integer","format":"int32","uniqueKey":"counters.error","typeLabel":"integer\u003cint32>"},"cancelled":{"type":"integer","format":"int32","uniqueKey":"counters.cancelled","typeLabel":"integer\u003cint32>"}},"additionalProperties":false,"description":"Runs per status; total is the sum of the others","uniqueKey":"counters","typeLabel":"object"},"tests":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"testId":{"oneOf":[{"type":"string","uniqueKey":"tests.oneOf.0.items.[INDEX].testId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"tests.oneOf.0.items.[INDEX].testId.oneOf.1","typeLabel":"null"}],"uniqueKey":"tests.oneOf.0.items.[INDEX].testId","typeLabel":"string | null"},"counters":{"type":"object","properties":{"total":{"type":"integer","format":"int32","uniqueKey":"tests.oneOf.0.items.[INDEX].counters.total","typeLabel":"integer\u003cint32>"},"queued":{"type":"integer","format":"int32","uniqueKey":"tests.oneOf.0.items.[INDEX].counters.queued","typeLabel":"integer\u003cint32>"},"running":{"type":"integer","format":"int32","uniqueKey":"tests.oneOf.0.items.[INDEX].counters.running","typeLabel":"integer\u003cint32>"},"passed":{"type":"integer","format":"int32","uniqueKey":"tests.oneOf.0.items.[INDEX].counters.passed","typeLabel":"integer\u003cint32>"},"failed":{"type":"integer","format":"int32","uniqueKey":"tests.oneOf.0.items.[INDEX].counters.failed","typeLabel":"integer\u003cint32>"},"error":{"type":"integer","format":"int32","uniqueKey":"tests.oneOf.0.items.[INDEX].counters.error","typeLabel":"integer\u003cint32>"},"cancelled":{"type":"integer","format":"int32","uniqueKey":"tests.oneOf.0.items.[INDEX].counters.cancelled","typeLabel":"integer\u003cint32>"}},"additionalProperties":false,"description":"Runs per status; total is the sum of the others","uniqueKey":"tests.oneOf.0.items.[INDEX].counters","typeLabel":"object"},"passRate":{"oneOf":[{"type":"number","description":"Passed / (passed + failed + error), between 0 and 1; null while no run has finished (cancelled runs are not counted)","format":"double","uniqueKey":"tests.oneOf.0.items.[INDEX].passRate.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","description":"Passed / (passed + failed + error), between 0 and 1; null while no run has finished (cancelled runs are not counted)","format":"double","uniqueKey":"tests.oneOf.0.items.[INDEX].passRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"tests.oneOf.0.items.[INDEX].passRate","typeLabel":"number\u003cdouble> | null"}},"additionalProperties":false,"description":"Outcome of one test inside an execution, over its repetitions","uniqueKey":"tests.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Per test, in testIds order: runs per status and pass rate over the repetitions","uniqueKey":"tests.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"testId":{"oneOf":[{"type":"string"},{"type":"null"}]},"counters":{"type":"object","properties":{"total":{"type":"integer","format":"int32"},"queued":{"type":"integer","format":"int32"},"running":{"type":"integer","format":"int32"},"passed":{"type":"integer","format":"int32"},"failed":{"type":"integer","format":"int32"},"error":{"type":"integer","format":"int32"},"cancelled":{"type":"integer","format":"int32"}},"additionalProperties":false,"description":"Runs per status; total is the sum of the others"},"passRate":{"oneOf":[{"type":"number","description":"Passed / (passed + failed + error), between 0 and 1; null while no run has finished (cancelled runs are not counted)","format":"double"},{"type":"null","description":"Passed / (passed + failed + error), between 0 and 1; null while no run has finished (cancelled runs are not counted)","format":"double"}]}},"additionalProperties":false,"description":"Outcome of one test inside an execution, over its repetitions"},"description":"Per test, in testIds order: runs per status and pass rate over the repetitions","uniqueKey":"tests.oneOf.1","typeLabel":"null"}],"uniqueKey":"tests","typeLabel":"object[] | null"}},"additionalProperties":false,"description":"One launch: the group of runs created together for a list of tests, each repeated `repetitions` times. Status, counters, tests, startedAt and finishedAt are derived from the runs.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","agentId":"\u003cstring>","name":"\u003cstring>","repetitions":123,"testIds":["\u003cstring>"],"status":"Queued","createdAt":"2023-11-07T05:31:56Z","startedAt":"2023-11-07T05:31:56Z","finishedAt":"2023-11-07T05:31:56Z","cancelledAt":"2023-11-07T05:31:56Z","counters":{"total":123,"queued":123,"running":123,"passed":123,"failed":123,"error":123,"cancelled":123},"tests":[{"testId":"\u003cstring>","counters":{"total":123,"queued":123,"running":123,"passed":123,"failed":123,"error":123,"cancelled":123},"passRate":123}]}}},"exampleType":"generated"}},"exampleType":"generated"},"c36fbc23-89a6-4852-be87-f8eec31323bf":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8192fbc3-1d65-4f55-907b-8d85d08092b0":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6d051e3a-5856-4c9e-8cb1-21d6bacdba77":{"description":"Client Error","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8bf500e5-5bc7-4b6c-ba18-3f5e88a6c4fa":{"Key":{"name":"X-Api-Key","type":"apiKey","in":"header"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"name":"X-Api-Key","type":"apiKey","in":"header"},"schema":{"title":"X-Api-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"Key","name":"X-Api-Key"}],"title":"Key"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"locuta","siteName":"Starleads api docs","title":"Launch tests - Starleads api docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-11T18:29:29.416Z","originalFileLocation":"api-reference/agenttestexecution/launch-tests.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=\"Launches tests of one of your agents and returns the execution immediately. Give testIds to launch a selection, or omit it to launch every test of the agent; repetitions (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Starleads api docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_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=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Launch tests - Starleads api docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Launches tests of one of your agents and returns the execution immediately. Give testIds to launch a selection, or omit it to launch every test of the agent; repetitions (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Starleads api docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://locuta.mintlify.app/_mintlify/api/og/v2?division=Agent+Test+Executions\u0026amp;title=Launch+tests\u0026amp;description=Launches+tests+of+one+of+your+agents+and+returns+the+execution+immediately.+Give+%60testIds%60+to+launch+a+selection%2C+or+omit+it+to+launch+every+test+of+the+agent%3B+\u0026amp;theme=5c5c29653f72fde3c80fdcde\u0026amp;signature=c82f15f2314e599d9dcfc4abe89eb10d7032dce679bcd363769f488371e3ff54\">\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=\"Launch tests - Starleads api docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Launches tests of one of your agents and returns the execution immediately. Give testIds to launch a selection, or omit it to launch every test of the agent; repetitions (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://locuta.mintlify.app/_mintlify/api/og/v2?division=Agent+Test+Executions\u0026amp;title=Launch+tests\u0026amp;description=Launches+tests+of+one+of+your+agents+and+returns+the+execution+immediately.+Give+%60testIds%60+to+launch+a+selection%2C+or+omit+it+to+launch+every+test+of+the+agent%3B+\u0026amp;theme=5c5c29653f72fde3c80fdcde\u0026amp;signature=c82f15f2314e599d9dcfc4abe89eb10d7032dce679bcd363769f488371e3ff54\">\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=\"/mintlify-assets/_mintlify/favicons/locuta/ynlCpXqW2nrSkjmQ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Starleads api docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF5B22\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agenttestexecution/launch-tests.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.starleads.co/#organization\",\"name\":\"Starleads api docs\",\"url\":\"https://docs.starleads.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/locuta/nbODknSPetkh4479/logo/logo-light.png?fit=max\u0026auto=format\u0026n=nbODknSPetkh4479\u0026q=85\u0026s=0c3dc57cc8eb4727a18bea5b413cfc61\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.starleads.co#website\",\"name\":\"Starleads api docs\",\"url\":\"https://docs.starleads.co\",\"publisher\":{\"@id\":\"https://docs.starleads.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests#webpage\",\"url\":\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests\",\"name\":\"Launch tests\",\"description\":\"Launches tests of one of your agents and returns the execution immediately. Give testIds to launch a selection, or omit it to launch every test of the agent; repetitions (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.\",\"dateModified\":\"2026-09-11T18:29:29.416Z\",\"isPartOf\":{\"@id\":\"https://docs.starleads.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Starleads api docs\",\"item\":\"https://docs.starleads.co\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Launch tests\",\"item\":\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests#apireference\",\"headline\":\"Launch tests\",\"name\":\"Launch tests\",\"description\":\"Launches tests of one of your agents and returns the execution immediately. Give testIds to launch a selection, or omit it to launch every test of the agent; repetitions (1-5) runs each test several times. Poll the execution until its status is Completed or Cancelled.\",\"url\":\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests\",\"mainEntityOfPage\":{\"@id\":\"https://docs.starleads.co/api-reference/agenttestexecution/launch-tests#webpage\"},\"dateModified\":\"2026-09-11T18:29:29.416Z\",\"publisher\":{\"@id\":\"https://docs.starleads.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.starleads.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Starleads api docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Starleads api docs","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":{"name":"book-open","style":"duotone"},"pages":[{"title":"Documentation","href":"/documentation/get-started"}]},{"anchor":"API Reference","icon":{"name":"square-terminal","style":"duotone"},"groups":[{"group":"API Reference","pages":[{"title":"API Reference","mode":"wide","href":"/api-reference/introduction"}]},{"group":"Consumption","pages":[{"title":"Get the current consumption","openapi":"GET /Consumption","href":"/api-reference/consumption/get-current-consumption"},{"title":"Get the consumption breakdown","openapi":"GET /Consumption/breakdown","href":"/api-reference/consumption/get-consumption-breakdown"},{"title":"List consumption transactions","openapi":"GET /Consumption/transactions","href":"/api-reference/consumption/get-consumption-transactions"}]},{"group":"Subscription","pages":[{"title":"Get the subscription contract","openapi":"GET /Subscription","href":"/api-reference/subscription/get-subscription-contract"}]},{"group":"Campaigns","pages":[{"title":"Get all campaigns","openapi":"GET /Campaign","href":"/api-reference/campaign/get-all-campaigns"},{"title":"Create a campaign","openapi":"POST /Campaign","href":"/api-reference/campaign/create-a-campaign"}]},{"group":"Campaign Items","pages":[{"title":"Get campaign items with filters","openapi":"GET /CampaignItem/{campaignId}/items","href":"/api-reference/campaignitem/get-campaign-items-with-filters"},{"title":"Get all items by phone number","openapi":"GET /CampaignItem/{campaignId}/{phoneNumber}","href":"/api-reference/campaignitem/get-all-items-by-phone-number"},{"title":"Add a new campaign item to a campaign","openapi":"POST /CampaignItem/{campaignId}","href":"/api-reference/campaignitem/add-a-new-campaign-item-to-a-campaign"},{"title":"Add multiple items to a campaign","openapi":"POST /CampaignItem/{campaignId}/bulk-add-items","href":"/api-reference/campaignitem/add-multiple-items-to-a-campaign"},{"title":"Delete an item from a campaign","openapi":"DELETE /CampaignItem/{campaignId}/{itemId}","href":"/api-reference/campaignitem/delete-an-item-from-a-campaign"},{"title":"Get item audio recording","openapi":"GET /CampaignItem/{itemId}/audio","href":"/api-reference/campaignitem/get-item-audio-recording"},{"title":"Delete item audio recording","openapi":"DELETE /CampaignItem/{itemId}/audio","href":"/api-reference/campaignitem/delete-item-audio-recording"}]},{"group":"Campaign Fields","pages":[{"title":"Get campaign's fields","openapi":"GET /CampaignField/{campaignId}","href":"/api-reference/campaignfield/get-campaigns-fields"}]},{"group":"Agents","pages":[{"title":"Get the prompt of an agent","openapi":"GET /Agent/{agentId}/prompt","href":"/api-reference/agent/get-the-prompt-of-an-agent"},{"title":"Update the prompt of an agent","openapi":"PUT /Agent/{agentId}/prompt","href":"/api-reference/agent/update-the-prompt-of-an-agent"},{"title":"Connect a knowledge base chat to an agent","openapi":"PUT /Agent/{agentId}/chat","href":"/api-reference/agent/connect-a-knowledge-base-chat-to-an-agent"},{"title":"Get the chat connected to an agent","openapi":"GET /Agent/{agentId}/chat","href":"/api-reference/agent/get-the-chat-connected-to-an-agent"},{"title":"Detach the chat from an agent","openapi":"DELETE /Agent/{agentId}/chat","href":"/api-reference/agent/detach-the-chat-from-an-agent"},{"title":"Get an agent","openapi":"GET /Agent/{agentId}","href":"/api-reference/agent/get-an-agent"},{"title":"List the tools connected to an agent","openapi":"GET /Agent/{agentId}/tools","href":"/api-reference/agent/list-the-tools-connected-to-an-agent"},{"title":"Connect a tool to an agent","openapi":"PUT /Agent/{agentId}/tools/{toolId}","href":"/api-reference/agent/connect-a-tool-to-an-agent"},{"title":"Disconnect a tool from an agent","openapi":"DELETE /Agent/{agentId}/tools/{toolId}","href":"/api-reference/agent/disconnect-a-tool-from-an-agent"},{"title":"Get the history of an agent","openapi":"GET /Agent/{agentId}/history","href":"/api-reference/agent/get-the-history-of-an-agent"}]},{"group":"Simulation Chat","pages":[{"title":"Start a simulation chat with an agent","openapi":"POST /SimulationChat/start","href":"/api-reference/simulationchat/start-a-simulation-chat-with-an-agent"},{"title":"Get a simulation chat","openapi":"GET /SimulationChat/{simulationChatId}","href":"/api-reference/simulationchat/get-a-simulation-chat"},{"title":"Send a message to a simulation chat","openapi":"POST /SimulationChat/send-message","href":"/api-reference/simulationchat/send-a-message-to-a-simulation-chat"}]},{"group":"Agent Tests","pages":[{"title":"List the tests of an agent","openapi":"GET /AgentTest","href":"/api-reference/agenttest/list-the-tests-of-an-agent"},{"title":"Get a test","openapi":"GET /AgentTest/{testId}","href":"/api-reference/agenttest/get-a-test"},{"title":"Delete a test","openapi":"DELETE /AgentTest/{testId}","href":"/api-reference/agenttest/delete-a-test"},{"title":"Create a simulation test","openapi":"POST /AgentTest/simulation","href":"/api-reference/agenttest/create-a-simulation-test"},{"title":"Update a simulation test","openapi":"PUT /AgentTest/simulation/{testId}","href":"/api-reference/agenttest/update-a-simulation-test"},{"title":"Create a classification test","openapi":"POST /AgentTest/classification","href":"/api-reference/agenttest/create-a-classification-test"},{"title":"Update a classification test","openapi":"PUT /AgentTest/classification/{testId}","href":"/api-reference/agenttest/update-a-classification-test"},{"title":"Move tests into a folder","openapi":"POST /AgentTest/move","href":"/api-reference/agenttest/move-tests-into-a-folder"}]},{"group":"Agent Test Folders","pages":[{"title":"List the folders of an agent","openapi":"GET /AgentTestFolder","href":"/api-reference/agenttestfolder/list-the-folders-of-an-agent"},{"title":"Get a folder","openapi":"GET /AgentTestFolder/{folderId}","href":"/api-reference/agenttestfolder/get-a-folder"},{"title":"Create a folder","openapi":"POST /AgentTestFolder","href":"/api-reference/agenttestfolder/create-a-folder"},{"title":"Update a folder","openapi":"PUT /AgentTestFolder/{folderId}","href":"/api-reference/agenttestfolder/update-a-folder"},{"title":"Delete a folder","openapi":"DELETE /AgentTestFolder/{folderId}","description":"Deletes a folder; its tests move back to the root of the agent. No test is deleted.","href":"/api-reference/agenttestfolder/delete-a-folder"}]},{"group":"Agent Test Executions","pages":[{"title":"Launch tests","openapi":"POST /AgentTestExecution","href":"/api-reference/agenttestexecution/launch-tests"},{"title":"Get an execution","openapi":"GET /AgentTestExecution/{executionId}","description":"Returns an execution with its status, its counters of runs per status and, per test, the pass rate over the repetitions. Status, counters and dates are derived from the runs.","href":"/api-reference/agenttestexecution/get-an-execution"},{"title":"List the executions of an agent","openapi":"GET /AgentTestExecution","href":"/api-reference/agenttestexecution/list-the-executions-of-an-agent"},{"title":"Cancel an execution","openapi":"POST /AgentTestExecution/{executionId}/cancel","href":"/api-reference/agenttestexecution/cancel-an-execution"}]},{"group":"Agent Test Runs","pages":[{"title":"Get a run","openapi":"GET /AgentTestRun/{runId}","href":"/api-reference/agenttestrun/get-a-run"},{"title":"List runs","openapi":"GET /AgentTestRun","href":"/api-reference/agenttestrun/list-runs"},{"title":"Cancel runs","openapi":"POST /AgentTestRun/cancel","href":"/api-reference/agenttestrun/cancel-runs"}]},{"group":"Knowledge Base — Datasets","pages":[{"title":"List datasets","openapi":"GET /Dataset","href":"/api-reference/dataset/list-datasets"},{"title":"Create a dataset","openapi":"POST /Dataset","href":"/api-reference/dataset/create-a-dataset"},{"title":"Get a dataset","openapi":"GET /Dataset/{datasetId}","href":"/api-reference/dataset/get-a-dataset"},{"title":"Update a dataset","openapi":"PATCH /Dataset/{datasetId}","href":"/api-reference/dataset/update-a-dataset"},{"title":"Delete a dataset","openapi":"DELETE /Dataset/{datasetId}","href":"/api-reference/dataset/delete-a-dataset"}]},{"group":"Knowledge Base — Documents","pages":[{"title":"List documents in a dataset","openapi":"GET /Dataset/{datasetId}/document","href":"/api-reference/document/list-documents-in-a-dataset"},{"title":"Upload documents to a dataset","openapi":"POST /Dataset/{datasetId}/document","href":"/api-reference/document/upload-documents-to-a-dataset"},{"title":"Download a document file","openapi":"GET /Dataset/{datasetId}/document/{documentId}/download","href":"/api-reference/document/download-a-document-file"},{"title":"Update a document","openapi":"PUT /Dataset/{datasetId}/document/{documentId}","href":"/api-reference/document/update-a-document"},{"title":"Delete a document","openapi":"DELETE /Dataset/{datasetId}/document/{documentId}","href":"/api-reference/document/delete-a-document"},{"title":"Trigger document parsing","openapi":"POST /Dataset/{datasetId}/document/parse","href":"/api-reference/document/trigger-document-parsing"},{"title":"Stop document parsing","openapi":"DELETE /Dataset/{datasetId}/document/parse","href":"/api-reference/document/stop-document-parsing"}]},{"group":"Knowledge Base — Chats","pages":[{"title":"List knowledge base chats","openapi":"GET /KnowledgeBaseChat","href":"/api-reference/knowledgebasechat/list-knowledge-base-chats"},{"title":"Create a knowledge base chat","openapi":"POST /KnowledgeBaseChat","href":"/api-reference/knowledgebasechat/create-a-knowledge-base-chat"},{"title":"Get a knowledge base chat","openapi":"GET /KnowledgeBaseChat/{chatId}","href":"/api-reference/knowledgebasechat/get-a-knowledge-base-chat"},{"title":"Update a knowledge base chat","openapi":"PATCH /KnowledgeBaseChat/{chatId}","href":"/api-reference/knowledgebasechat/update-a-knowledge-base-chat"},{"title":"Delete a knowledge base chat","openapi":"DELETE /KnowledgeBaseChat/{chatId}","href":"/api-reference/knowledgebasechat/delete-a-knowledge-base-chat"}]},{"group":"Knowledge Base — Knowledge Graph","pages":[{"title":"Enable knowledge graph on a dataset","openapi":"POST /Dataset/{datasetId}/knowledge-graph/enable","href":"/api-reference/knowledgegraph/enable-knowledge-graph-on-a-dataset"},{"title":"Trigger knowledge graph construction","openapi":"POST /Dataset/{datasetId}/knowledge-graph/build","href":"/api-reference/knowledgegraph/trigger-knowledge-graph-construction"},{"title":"Get knowledge graph build status","openapi":"GET /Dataset/{datasetId}/knowledge-graph/status","href":"/api-reference/knowledgegraph/get-knowledge-graph-build-status"},{"title":"Get the knowledge graph","openapi":"GET /Dataset/{datasetId}/knowledge-graph","href":"/api-reference/knowledgegraph/get-the-knowledge-graph"},{"title":"Delete the knowledge graph","openapi":"DELETE /Dataset/{datasetId}/knowledge-graph","href":"/api-reference/knowledgegraph/delete-the-knowledge-graph"}]}]}]},"title":"Launch tests - Starleads api docs","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}