Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project’s last job, unless force is true.
Absent for a scheduled job or one launched with an API key
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MentionLab","colors":{"primary":"#44c5e4","light":"#84E7FF","dark":"#2BA3C0"},"logo":{"light":"https://mintcdn.com/mentionlab/nh8jVOL0ziHLP1FN/logo/light.svg?fit=max\u0026auto=format\u0026n=nh8jVOL0ziHLP1FN\u0026q=85\u0026s=a72bc6fa216352f75d58b2e3b7386cfe","dark":"https://mintcdn.com/mentionlab/nh8jVOL0ziHLP1FN/logo/dark.svg?fit=max\u0026auto=format\u0026n=nh8jVOL0ziHLP1FN\u0026q=85\u0026s=259e3fab8bcb1cf98e3c0ceed6d1be55"},"favicon":"https://mintcdn.com/mentionlab/BZO4YAwLhtwgZHmy/favicon.svg?fit=max\u0026auto=format\u0026n=BZO4YAwLhtwgZHmy\u0026q=85\u0026s=12698a171eeb758c5ac182bbee13c650","background":{"color":{"dark":"#171717"}},"navbar":{"links":[{"href":"mailto:support@mentionlab.io","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.mentionlab.io"}},"footer":{"socials":{"github":"https://github.com/mentionlab","linkedin":"https://linkedin.com/company/mentionlab"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"globe","href":"https://status.mentionlab.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mentionlab","hasAudioNarration":false,"actualSubdomain":"mentionlab","customDomains":["docs.mentionlab.io"],"gitSource":{"type":"github","owner":"mentionlab","repo":"docs.mentionlab.io","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad6526a06204c9723e12ac5","collectionId":"6e99bfff-a9d2-4c15-8cbd-40e543ad8524","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad6526a06204c9723e12ac5"},"entitlements":{},"buildId":"6aecdb1f0887c8c72ee19927","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"REST API (legacy)","count":141},{"language":"default","tag":"Documentation","count":19},{"language":"default","tag":"Entities","count":14},{"language":"default","tag":"REST API v2 (alpha)","count":10},{"language":"default","tag":"Analytics - Sources","count":8},{"language":"default","tag":"Analytics - Tags","count":8},{"language":"default","tag":"Execution Tags","count":8},{"language":"default","tag":"Projects","count":8},{"language":"default","tag":"Source Topics","count":8},{"language":"default","tag":"Tags","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"rest-api-v2/reference/jobs/launch-an-analysis","slug":"/rest-api-v2/reference/jobs/launch-an-analysis","pageMetadata":{"title":"Launch an analysis","description":"Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project's last job, unless `force` is true.","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json post /api/v2/projects/{projectId}/jobs","href":"/rest-api-v2/reference/jobs/launch-an-analysis","autogeneratedByOpenApi":true},"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: [\"Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project’s last job, unless \", _jsx(_components.code, {\n children: \"force\"\n }), \" is true.\"]\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 an analysis","description":"Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project's last job, unless `force` is true.","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json post /api/v2/projects/{projectId}/jobs","href":"/rest-api-v2/reference/jobs/launch-an-analysis","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/mentionlab/c64d9e021e887e3b/rybbit.js"],"openApiReferenceData":{"operation":{"description":"Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project's last job, unless `force` is true.","operationId":"JobsV2Controller_launch_v2","parameters":["f93a4cb1-89c3-411f-996e-f336ec421696","359825d4-090b-4a89-90d6-d5078f4ddd79"],"requestBody":"e03cb1e9-6e09-455e-9df7-f96cc3c92f76","responses":{"201":"38980c50-f20a-42db-a5d2-a0b9731a65d0","400":"db9d4f12-1bbd-4b31-bf4c-aece426bfeaf","401":"39ea8e93-e426-466f-90b6-98649f596f6a","403":"682c0c76-fe83-4809-aae7-74484de99c97"},"summary":"Launch an analysis","tags":["Jobs"],"x-public-api":true,"method":"post","type":"path","servers":["7844a278-09a5-4421-935b-fc9ffde6039e"],"security":[],"path":"/api/v2/projects/{projectId}/jobs","baseUrlOptions":["https://api.mentionlab.io"],"title":"Launch an analysis","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f93a4cb1-89c3-411f-996e-f336ec421696":{"name":"x-project-id","in":"header","description":"Project ID to specify the project context","required":true,"schema":{"type":"string","isRequired":true,"description":"Project ID to specify the project context","uniqueKey":"","typeLabel":"string"}},"359825d4-090b-4a89-90d6-d5078f4ddd79":{"name":"projectId","required":true,"in":"path","schema":{"format":"uuid","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aiModels":{"description":"Models that answer every selected query, by id or rolling alias","example":["scp-ml-chatgpt","claude-haiku-latest"],"uniqueItems":true,"type":"array","items":{"type":"string","uniqueKey":"aiModels.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"aiModels","typeLabel":"string[]"},"executionCount":{"type":"number","minimum":1,"maximum":100,"description":"How many times each query runs on each model","example":3,"isRequired":true,"uniqueKey":"executionCount","typeLabel":"number"},"selection":{"type":"object","description":"Absent: every query of the project","required":["mode"],"properties":{"mode":{"type":"string","enum":["include","all"],"description":"How the target set is defined. \"include\" acts on the given ids; \"all\" acts on everything matching the filter except the excluded ids.","isRequired":true,"uniqueKey":"selection.mode","typeLabel":"enum\u003cstring>"},"ids":{"description":"Uuids of the rows to act on, required when mode is \"include\"","example":["018f3a2b-7c4d-7e91-b3f5-2a6c8d0e1f42"],"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"selection.ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"selection.ids","typeLabel":"string\u003cuuid>[]"},"excludedIds":{"description":"Uuids to subtract from the matched set, only used when mode is \"all\"","example":["018f3a2b-7c4d-7e91-b3f5-2a6c8d0e1f42"],"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"selection.excludedIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"selection.excludedIds","typeLabel":"string\u003cuuid>[]"},"filter":{"type":"object","description":"Used when mode is \"all\"","properties":{"page":{"type":"number","description":"Which slice of the matched rows to return, counted from 1. Rows skipped are (page - 1) * limit.","default":1,"minimum":1,"example":2,"uniqueKey":"selection.filter.page","typeLabel":"number"},"limit":{"type":"number","description":"How many rows one page holds, capped at 100 to keep a single response bounded.","default":25,"minimum":1,"maximum":100,"example":50,"uniqueKey":"selection.filter.limit","typeLabel":"number"},"search":{"type":"string","description":"Substring of the query text, accents and apostrophes folded","example":"running shoes","uniqueKey":"selection.filter.search","typeLabel":"string"},"languages":{"description":"Queries in any of these languages, as reference locale language codes","example":["en","fr"],"type":"array","items":{"type":"string","uniqueKey":"selection.filter.languages.items.[INDEX]","typeLabel":"string"},"uniqueKey":"selection.filter.languages","typeLabel":"string[]"},"countries":{"description":"Queries run for any of these markets, as country codes of the reference locales","example":["US","GB"],"type":"array","items":{"type":"string","uniqueKey":"selection.filter.countries.items.[INDEX]","typeLabel":"string"},"uniqueKey":"selection.filter.countries","typeLabel":"string[]"},"types":{"type":"array","description":"An untyped query matches none","items":{"type":"string","enum":["comparative","informative","perception"],"description":"The type of question the query asks: \"comparative\" (compares options), \"informative\" (seeks facts or how-to information) or \"perception\" (probes opinions about a brand).","uniqueKey":"selection.filter.types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"selection.filter.types","typeLabel":"enum\u003cstring>[]"},"tagIds":{"description":"Queries carrying these tags, by tag id. See tagMode","example":[12,34],"type":"array","items":{"type":"number","uniqueKey":"selection.filter.tagIds.items.[INDEX]","typeLabel":"number"},"uniqueKey":"selection.filter.tagIds","typeLabel":"number[]"},"tagGroupIds":{"description":"Queries with a tag of these groups. See tagMode","example":["018f3a2b-7c4d-7e91-b3f5-2a6c8d0e1f42"],"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"selection.filter.tagGroupIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"selection.filter.tagGroupIds","typeLabel":"string\u003cuuid>[]"},"tagMode":{"type":"string","enum":["and","or"],"description":"\"and\" (default): every tag, and a tag of each group. \"or\": any tag, or a tag of any group","uniqueKey":"selection.filter.tagMode","typeLabel":"enum\u003cstring>"},"recurrenceSettingIds":{"description":"Queries on any of these schedules","example":["018f3a2b-7c4d-7e91-b3f5-2a6c8d0e1f42"],"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"selection.filter.recurrenceSettingIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"selection.filter.recurrenceSettingIds","typeLabel":"string\u003cuuid>[]"},"hasRecurrenceSetting":{"type":"boolean","description":"Whether a schedule runs them","example":true,"uniqueKey":"selection.filter.hasRecurrenceSetting","typeLabel":"boolean"},"sort":{"type":"string","description":"Comma-separated field:asc|desc pairs. Sortable: query, updatedAt.","example":"query:asc","uniqueKey":"selection.filter.sort","typeLabel":"string"}},"uniqueKey":"selection.filter","typeLabel":"object"}},"uniqueKey":"selection","typeLabel":"object"},"force":{"type":"boolean","description":"Launch even if a job started in the last 10 minutes","example":true,"uniqueKey":"force","typeLabel":"boolean"}},"required":["aiModels","executionCount"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"aiModels":["scp-ml-chatgpt","claude-haiku-latest"],"executionCount":3,"force":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"38980c50-f20a-42db-a5d2-a0b9731a65d0":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Id of the run, used to poll it and to list its executions","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["pending","processing","syncing","completed","failed","partial_failed"],"description":"Run state: pending, processing, syncing (finished, results still reaching analytics), then completed, failed or partial_failed","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"totalExecutions":{"type":"number","description":"Executions the run holds: one per query, model and repeat","isRequired":true,"uniqueKey":"totalExecutions","typeLabel":"number"},"pendingExecutions":{"type":"number","description":"Executions still queued or in flight, with no answer yet","isRequired":true,"uniqueKey":"pendingExecutions","typeLabel":"number"},"retryingExecutions":{"type":"number","description":"Executions that failed an attempt and are queued for another","isRequired":true,"uniqueKey":"retryingExecutions","typeLabel":"number"},"successExecutions":{"type":"number","description":"Executions that came back with an answer","isRequired":true,"uniqueKey":"successExecutions","typeLabel":"number"},"failedExecutions":{"type":"number","description":"Executions that gave up, their attempts spent","isRequired":true,"uniqueKey":"failedExecutions","typeLabel":"number"},"createdAt":{"type":"string","format":"date-time","description":"When the run was launched","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"When a counter or the status last moved; a poller watches this","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"createdBy":{"type":"object","description":"Absent for a scheduled job or one launched with an API key","required":["id","firstName","lastName","email"],"properties":{"id":{"type":"string","format":"uuid","description":"Id of the user who launched the job","example":"9f1c2d3e-4a5b-4c6d-8e7f-0a1b2c3d4e5f","isRequired":true,"uniqueKey":"createdBy.id","typeLabel":"string\u003cuuid>"},"firstName":{"type":"string","description":"Given name on that user's profile","example":"Ada","isRequired":true,"uniqueKey":"createdBy.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Family name on that user's profile","example":"Lovelace","isRequired":true,"uniqueKey":"createdBy.lastName","typeLabel":"string"},"email":{"type":"string","description":"Address that user signs in with","example":"ada.lovelace@example.com","isRequired":true,"uniqueKey":"createdBy.email","typeLabel":"string"}},"uniqueKey":"createdBy","typeLabel":"object"}},"required":["id","status","totalExecutions","pendingExecutions","retryingExecutions","successExecutions","failedExecutions","createdAt","updatedAt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"pending","totalExecutions":123,"pendingExecutions":123,"retryingExecutions":123,"successExecutions":123,"failedExecutions":123,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","createdBy":{"id":"9f1c2d3e-4a5b-4c6d-8e7f-0a1b2c3d4e5f","firstName":"Ada","lastName":"Lovelace","email":"ada.lovelace@example.com"}}}},"exampleType":"generated"}},"exampleType":"generated"},"db9d4f12-1bbd-4b31-bf4c-aece426bfeaf":{"description":"The request failed validation — the body, query or path parameters are malformed or out of range.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code of the error.","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Human-readable description of the error. Validation failures return an array of per-field validation errors instead of a single string.","example":"Validation failed","uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","description":"Short name of the HTTP error.","example":"Bad Request","uniqueKey":"error","typeLabel":"string"}},"required":["statusCode"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"Validation failed","error":"Bad Request"}}},"exampleType":"generated"}},"exampleType":"generated"},"39ea8e93-e426-466f-90b6-98649f596f6a":{"description":"The request is missing valid authentication credentials.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code of the error.","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Human-readable description of the error. Validation failures return an array of per-field validation errors instead of a single string.","example":"Validation failed","uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","description":"Short name of the HTTP error.","example":"Bad Request","uniqueKey":"error","typeLabel":"string"}},"required":["statusCode"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"Validation failed","error":"Bad Request"}}},"exampleType":"generated"}},"exampleType":"generated"},"682c0c76-fe83-4809-aae7-74484de99c97":{"description":"The authenticated principal lacks the required permission, or access to the requested organisation/project.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code of the error.","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Human-readable description of the error. Validation failures return an array of per-field validation errors instead of a single string.","example":"Validation failed","uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","description":"Short name of the HTTP error.","example":"Bad Request","uniqueKey":"error","typeLabel":"string"}},"required":["statusCode"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"Validation failed","error":"Bad Request"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"7844a278-09a5-4421-935b-fc9ffde6039e":{"url":"https://api.mentionlab.io"}}},"originalFileLocation":"https://api.mentionlab.io/api/docs/v2-json"},"subdomain":"mentionlab","siteName":"MentionLab","title":"Launch an analysis - MentionLab","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T19:38:14.598Z","originalFileLocation":"rest-api-v2/reference/jobs/launch-an-analysis.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=\"Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project\u0026#x27;s last job, unless force is true.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MentionLab\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mentionlab/GPawiplNfjdcR17j/_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/mentionlab/GPawiplNfjdcR17j/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mentionlab/GPawiplNfjdcR17j/_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/mentionlab/GPawiplNfjdcR17j/_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/mentionlab/GPawiplNfjdcR17j/_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/mentionlab/GPawiplNfjdcR17j/_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/mentionlab/GPawiplNfjdcR17j/_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/mentionlab/GPawiplNfjdcR17j/_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/mentionlab/GPawiplNfjdcR17j/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Launch an analysis - MentionLab\">\u003cmeta data-mint-head property=\"og:description\" content=\"Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project\u0026#x27;s last job, unless force is true.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MentionLab\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mentionlab.mintlify.site/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Launch+an+analysis\u0026amp;description=Runs+the+selected+queries%2C+or+all+of+them%2C+on+the+chosen+models.+Charges+the+credits+up+front.+Refused+%28409+RECENT_JOB_EXISTS%29+within+10+minutes+of+the+project%27\u0026amp;theme=21fc8b437c90d21db3f070e6\u0026amp;signature=23d171377f6dc47211eff6e2b61d7959e0308e43da600426d3f53d8e4614c72f\">\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 an analysis - MentionLab\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project\u0026#x27;s last job, unless force is true.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mentionlab.mintlify.site/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Launch+an+analysis\u0026amp;description=Runs+the+selected+queries%2C+or+all+of+them%2C+on+the+chosen+models.+Charges+the+credits+up+front.+Refused+%28409+RECENT_JOB_EXISTS%29+within+10+minutes+of+the+project%27\u0026amp;theme=21fc8b437c90d21db3f070e6\u0026amp;signature=23d171377f6dc47211eff6e2b61d7959e0308e43da600426d3f53d8e4614c72f\">\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/mentionlab/GPawiplNfjdcR17j/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MentionLab\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#44c5e4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/rest-api-v2/reference/jobs/launch-an-analysis.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mentionlab.io/#organization\",\"name\":\"MentionLab\",\"url\":\"https://docs.mentionlab.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mentionlab/nh8jVOL0ziHLP1FN/logo/light.svg?fit=max\u0026auto=format\u0026n=nh8jVOL0ziHLP1FN\u0026q=85\u0026s=a72bc6fa216352f75d58b2e3b7386cfe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mentionlab.io#website\",\"name\":\"MentionLab\",\"url\":\"https://docs.mentionlab.io\",\"publisher\":{\"@id\":\"https://docs.mentionlab.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis#webpage\",\"url\":\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis\",\"name\":\"Launch an analysis\",\"description\":\"Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project's last job, unless force is true.\",\"dateModified\":\"2026-11-05T19:38:14.598Z\",\"isPartOf\":{\"@id\":\"https://docs.mentionlab.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"MentionLab\",\"item\":\"https://docs.mentionlab.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Launch an analysis\",\"item\":\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis#apireference\",\"headline\":\"Launch an analysis\",\"name\":\"Launch an analysis\",\"description\":\"Runs the selected queries, or all of them, on the chosen models. Charges the credits up front. Refused (409 RECENT_JOB_EXISTS) within 10 minutes of the project's last job, unless force is true.\",\"url\":\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mentionlab.io/rest-api-v2/reference/jobs/launch-an-analysis#webpage\"},\"dateModified\":\"2026-11-05T19:38:14.598Z\",\"publisher\":{\"@id\":\"https://docs.mentionlab.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mentionlab.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MentionLab\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"MentionLab","nav":{"global":{"anchors":[{"anchor":"Status","icon":"globe","href":"https://status.mentionlab.io"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"REST API (legacy)","pages":[{"title":"REST API (legacy)","href":"/rest-api/getting-started"}]},{"tab":"REST API v2 (alpha)","groups":[{"group":"Overview","pages":[{"title":"Getting Started","tag":"ALPHA","href":"/rest-api-v2/getting-started"}]},{"group":"Provider Restrictions","pages":[{"title":"List the models the project may launch","description":"The models a launch or a schedule of the project can run, under the organisation's plan.","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json get /api/v2/projects/{projectId}/launchable-models","href":"/rest-api-v2/reference/provider-restrictions/list-the-models-the-project-may-launch"}]},{"group":"Jobs","pages":[{"title":"Launch an analysis","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json post /api/v2/projects/{projectId}/jobs","href":"/rest-api-v2/reference/jobs/launch-an-analysis"},{"title":"Estimate the credits a launch costs","description":"The same body as a launch. Charges nothing.","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json post /api/v2/projects/{projectId}/jobs/estimate","href":"/rest-api-v2/reference/jobs/estimate-the-credits-a-launch-costs"}]},{"group":"Recurrence settings","pages":[{"title":"List the project's schedules","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json get /api/v2/projects/{projectId}/recurrence-settings","href":"/rest-api-v2/reference/recurrence-settings/list-the-projects-schedules"},{"title":"Create a schedule","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json post /api/v2/projects/{projectId}/recurrence-settings","href":"/rest-api-v2/reference/recurrence-settings/create-a-schedule"},{"title":"Delete a schedule","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json delete /api/v2/projects/{projectId}/recurrence-settings/{recurrenceSettingId}","href":"/rest-api-v2/reference/recurrence-settings/delete-a-schedule"},{"title":"Edit, pause or resume a schedule","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json patch /api/v2/projects/{projectId}/recurrence-settings/{recurrenceSettingId}","href":"/rest-api-v2/reference/recurrence-settings/edit-pause-or-resume-a-schedule"},{"title":"Add a selection of queries to a schedule","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json post /api/v2/projects/{projectId}/recurrence-settings/{recurrenceSettingId}/queries/bulk/add","href":"/rest-api-v2/reference/recurrence-settings/add-a-selection-of-queries-to-a-schedule"},{"title":"Remove a selection of queries from a schedule","deprecated":null,"version":null,"openapi":"https://api.mentionlab.io/api/docs/v2-json post /api/v2/projects/{projectId}/recurrence-settings/{recurrenceSettingId}/queries/bulk/remove","href":"/rest-api-v2/reference/recurrence-settings/remove-a-selection-of-queries-from-a-schedule"}]}]}]},"basePath":"","title":"Launch an analysis - MentionLab","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","Page-CxAy5y67.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","clsx-C5EfhVm0.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CJ9Oly2E.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Mk6P3qvh.js"]}