A task settles at completed, failed, or cancelled. Read this endpoint again for its current status.
status
Meaning
idle
No message has been sent yet
running
The agent is working
completed
The agent finished this turn and no background work is running
failed
The latest agent message carries an error, or the task stopped because your workspace’s prepaid credits ran out
cancelled
You stopped the task
When a task stops because your workspace’s prepaid credits ran out, status is failed and error says why, with codepayment_required. Send a new message after adding credits to continue the task.reviews holds the scientific reviews of this task, each with its status, the message_id of the message holding the findings, and error_message on a failure. A review appears once it has written its findings.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Biomni Lab","colors":{"primary":"#8B8E2A","light":"#EAED69","dark":"#6B6E1A"},"logo":{"light":"https://mintcdn.com/phylo/mMFc9n_OTo2ELHF4/images/logo-dark.png?fit=max\u0026auto=format\u0026n=mMFc9n_OTo2ELHF4\u0026q=85\u0026s=20429d44f98211a4ac89eb66ffa32a19","dark":"https://mintcdn.com/phylo/VePq9ir7KxluClcL/images/logo-light.png?fit=max\u0026auto=format\u0026n=VePq9ir7KxluClcL\u0026q=85\u0026s=aae8dd24693d7635ceb8d69045dd9695"},"favicon":"https://mintcdn.com/phylo/mMFc9n_OTo2ELHF4/images/favicon.png?fit=max\u0026auto=format\u0026n=mMFc9n_OTo2ELHF4\u0026q=85\u0026s=1002990a5a43b368cf22a3924b359bf7","api":{"playground":{"display":"simple"}},"background":{"color":{"light":"#F7F6F2","dark":"#141413"}},"navbar":{"links":[{"href":"mailto:support@phylo.bio","label":"Support"}],"primary":{"type":"button","label":"Open Biomni Lab","href":"https://app.phylo.bio"}},"footer":{"socials":{"website":"https://phylo.bio","slack":"https://join.slack.com/t/biomnigroup/shared_invite/zt-478z7aarm-~JC0jFpGZZorug6FhcuZFA"}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Slack Community","icon":"slack","href":"https://join.slack.com/t/biomnigroup/shared_invite/zt-478z7aarm-~JC0jFpGZZorug6FhcuZFA"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"phylo","hasAudioNarration":false,"actualSubdomain":"phylo","customDomains":["docs.biomni.phylo.bio"],"gitSource":{"type":"github","owner":"phylo-dev","repo":"phylo-monolith","deployBranch":"main","contentDirectory":"product-docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af3b71057e236a3f328cd45","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API","count":32},{"language":"default","tag":"API reference","count":24},{"language":"default","tag":"Documentation","count":20},{"language":"default","tag":"Tasks","count":12},{"language":"default","tag":"Work in Biomni","count":7},{"language":"default","tag":"Files","count":6},{"language":"default","tag":"Projects","count":5},{"language":"default","tag":"Messages","count":4},{"language":"default","tag":"Guides","count":4},{"language":"default","tag":"Recipes","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"html:not(.dark) a{color:#8B8E2A!important}html:not(.dark) a:hover{color:#6B6E1A!important}html:not(.dark) :is(button,button:hover,button:focus,button:active,button[data-primary=\"true\"],.btn-primary,[class*=\"primary\"] button,[type=\"button\"],[type=\"submit\"],a:active,a[aria-current=\"page\"],a[aria-current=\"true\"],a:focus,nav button:active,[role=\"tab\"],[data-type=\"card\"],[data-sidebar] a,[class*=\"bg-primary\"],[class*=\"bg-accent\"],[style*=\"background\"],.mintlify-button){color:#000000!important}.dark{--biomni-lime: #EAED69;--biomni-lime-soft: #D6D96A;--biomni-surface: #1C1C1A;--biomni-border: rgba(255, 255, 255, 0.08)}.dark #content-area .prose a:not([class]),.dark #content-area a.link{color:var(--biomni-lime-soft);text-decoration-color:rgba(234, 237, 105, 0.4)}.dark #content-area .prose a:not([class]):hover,.dark #content-area a.link:hover{color:var(--biomni-lime);text-decoration-color:var(--biomni-lime)}.dark #topbar-cta-button a>span:first-child{background-color:var(--biomni-lime)}.dark #topbar-cta-button a :is(span,svg){color:#141413}.dark .card{background-color:var(--biomni-surface);border-color:var(--biomni-border)}.dark .card:hover{background-color:#222220}.dark :is(.code-block,.code-group){border-color:var(--biomni-border)}.dark ::selection{background-color:rgba(234, 237, 105, 0.25)}.method-nav-pill{width:auto!important}.method-nav-pill>span{display:inline-block;min-width:2.6rem;text-align:center}.primitive-param-field .py-6{padding-top:0.6rem;padding-bottom:0.6rem}.api-section:first-of-type{display:none}"}],"page":{"pagePath":"api-reference/pages/get-task","slug":"/api-reference/pages/get-task","pageMetadata":{"title":"Get a task","openapi":"api-reference/openapi.json GET /experimental/tasks/{task_id}","description":"Get a task, its status, and any scientific reviews of it.","href":"/api-reference/pages/get-task"},"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: \"Get a task, its status, and any scientific reviews of it.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Table}=_components;if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A task settles at `,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`failed`}),`, or `,_jsx(_components.code,{children:`cancelled`}),`. Read this endpoint again for its current status.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`idle`})}),_jsx(_components.td,{children:`No message has been sent yet`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`running`})}),_jsx(_components.td,{children:`The agent is working`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completed`})}),_jsx(_components.td,{children:`The agent finished this turn and no background work is running`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`failed`})}),_jsxs(_components.td,{children:[`The latest agent message carries an `,_jsx(_components.code,{children:`error`}),`, or the task stopped because your workspace’s prepaid credits ran out`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cancelled`})}),_jsx(_components.td,{children:`You stopped the task`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`When a task stops because your workspace’s prepaid credits ran out, `,_jsx(_components.code,{children:`status`}),` is `,_jsx(_components.code,{children:`failed`}),` and `,_jsx(_components.code,{children:`error`}),` says why, with `,_jsx(_components.code,{children:`code`}),` `,_jsx(_components.code,{children:`payment_required`}),`. Send a new message after adding credits to continue the task.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`reviews`}),` holds the `,_jsx(_components.a,{href:`/api-reference/pages/review-task`,children:`scientific reviews`}),` of this task, each with its `,_jsx(_components.code,{children:`status`}),`, the `,_jsx(_components.code,{children:`message_id`}),` of the message holding the findings, and `,_jsx(_components.code,{children:`error_message`}),` on a failure. A review appears once it has written its findings.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a task","openapi":"api-reference/openapi.json GET /experimental/tasks/{task_id}","description":"Get a task, its status, and any scientific reviews of it.","href":"/api-reference/pages/get-task"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["tasks"],"summary":"Get a task","description":"Get a task, its status, and any scientific reviews of it.","operationId":"get_task_experimental_tasks__task_id__get","parameters":["e7684939-8121-4905-86c9-0946ef2bb94d"],"responses":{"200":"b8a6fa10-1d15-4b0a-a645-d354accf7960"},"security":["9c1f659d-5321-4ddb-b020-b192c6d4a301"],"method":"get","type":"path","servers":["c7957519-c805-475d-8b3a-f061dd8a3664"],"path":"/experimental/tasks/{task_id}","baseUrlOptions":["https://api.phylo.bio/v1"],"title":"Get a task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e7684939-8121-4905-86c9-0946ef2bb94d":{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"b8a6fa10-1d15-4b0a-a645-d354accf7960":{"description":"Task record.","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","title":"Created At","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"status":{"type":"string","enum":["idle","running","completed","cancelled","failed"],"title":"Status","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"type":{"type":"string","const":"task","title":"Type","default":"task","uniqueKey":"type","typeLabel":"string"},"error":{"oneOf":[{"type":"object","title":"TaskError","description":"Why the task failed, when the reason is known. Set only when `status` is `failed`.","required":["type","code","message"],"properties":{"type":{"type":"string","const":"invalid_request_error","title":"Type","isRequired":true,"uniqueKey":"error.oneOf.0.type","typeLabel":"string"},"code":{"type":"string","const":"payment_required","title":"Code","isRequired":true,"uniqueKey":"error.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"}},"uniqueKey":"error.oneOf.0","typeLabel":"TaskError · object"},{"type":"null","description":"Why the task failed, when the reason is known. Set only when `status` is `failed`.","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"TaskError · object | null"},"project_id":{"oneOf":[{"type":"string","title":"Project Id","uniqueKey":"project_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Project Id","uniqueKey":"project_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"project_id","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"platform":{"type":"string","enum":["api","mcp","web","desktop","mobile"],"title":"Platform","default":"api","uniqueKey":"platform","typeLabel":"enum\u003cstring>"},"reviews":{"oneOf":[{"type":"array","items":{"properties":{"status":{"type":"string","enum":["running","done","failed"],"title":"Status","isRequired":true,"uniqueKey":"reviews.oneOf.0.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","title":"Created At","isRequired":true,"uniqueKey":"reviews.oneOf.0.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"type":{"type":"string","const":"scientific_review","title":"Type","default":"scientific_review","uniqueKey":"reviews.oneOf.0.items.[INDEX].type","typeLabel":"string"},"message_id":{"oneOf":[{"type":"string","title":"Message Id","uniqueKey":"reviews.oneOf.0.items.[INDEX].message_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message Id","uniqueKey":"reviews.oneOf.0.items.[INDEX].message_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"reviews.oneOf.0.items.[INDEX].message_id","typeLabel":"string | null"},"error_message":{"oneOf":[{"type":"string","title":"Error Message","uniqueKey":"reviews.oneOf.0.items.[INDEX].error_message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Error Message","uniqueKey":"reviews.oneOf.0.items.[INDEX].error_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"reviews.oneOf.0.items.[INDEX].error_message","typeLabel":"string | null"}},"type":"object","required":["status","created_at"],"title":"TaskScientificReview","description":"A scientific review recorded on a task.","uniqueKey":"reviews.oneOf.0.items.[INDEX]","typeLabel":"TaskScientificReview · object"},"title":"Reviews","uniqueKey":"reviews.oneOf.0","typeLabel":"TaskScientificReview · object[]"},{"type":"null","title":"Reviews","uniqueKey":"reviews.oneOf.1","typeLabel":"null"}],"uniqueKey":"reviews","typeLabel":"TaskScientificReview · object[] | null"}},"type":"object","required":["id","created_at","status"],"title":"Task","uniqueKey":"","typeLabel":"Task · object"},"examples":{"completed":{"title":"completed","value":{"id":"tsk_017ilCeuDpMWTSH9Ah1syUGJ","type":"task","created_at":"2026-08-12T21:21:02.815000Z","status":"completed","project_id":"prj_014OwAG97UY0UfcHlLHQRnKO","title":"BRCA1 variant workup","platform":"api","reviews":[]}},"running":{"title":"running","value":{"id":"tsk_014ztPoW8a1jnkHm9jMZ1KML","type":"task","created_at":"2026-08-12T21:02:18.900000Z","status":"running","project_id":"prj_014OwAG97UY0UfcHlLHQRnKO","title":"BRCA1 variant exploration","platform":"api","reviews":[]}},"reviewed":{"title":"reviewed","value":{"id":"tsk_017ilCeuDpMWTSH9Ah1syUGJ","type":"task","created_at":"2026-08-12T21:21:02.815000Z","status":"completed","project_id":"prj_014OwAG97UY0UfcHlLHQRnKO","title":"BRCA1 variant workup","platform":"api","reviews":[{"type":"scientific_review","status":"done","created_at":"2026-08-12T21:41:02Z","message_id":"msg_f6872d1e0fb242fd"}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"9c1f659d-5321-4ddb-b020-b192c6d4a301":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Requires an API key. See the Authentication guide.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"c7957519-c805-475d-8b3a-f061dd8a3664":{"url":"https://api.phylo.bio/v1","description":"Self-serve platform. Enterprise customers should contact the Phylo team to get their API base URL. Learn more at https://phylo.bio/enterprise."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Requires an API key. See the Authentication guide.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Requires an API key. See the Authentication guide.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"phylo","siteName":"Biomni Lab","title":"Get a task - Biomni Lab","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T00:29:42.814Z","originalFileLocation":"api-reference/pages/get-task.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=\"Get a task, its status, and any scientific reviews of it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Biomni Lab\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/phylo/up0yDM567jnQyYsi/_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/phylo/up0yDM567jnQyYsi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/phylo/up0yDM567jnQyYsi/_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/phylo/up0yDM567jnQyYsi/_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/phylo/up0yDM567jnQyYsi/_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/phylo/up0yDM567jnQyYsi/_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/phylo/up0yDM567jnQyYsi/_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/phylo/up0yDM567jnQyYsi/_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/phylo/up0yDM567jnQyYsi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a task - Biomni Lab\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a task, its status, and any scientific reviews of it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Biomni Lab\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.biomni.phylo.bio/api-reference/pages/get-task\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://phylo.mintlify.site/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Get+a+task\u0026amp;description=Get+a+task%2C+its+status%2C+and+any+scientific+reviews+of+it.\u0026amp;theme=33b2e769a9dcc417ef28c1d1\u0026amp;signature=82d6f4aeaa67904d6d25b0db2c3b7d9a50fd85b379d79b9fe3004acbddedf56c\">\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=\"Get a task - Biomni Lab\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a task, its status, and any scientific reviews of it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://phylo.mintlify.site/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Get+a+task\u0026amp;description=Get+a+task%2C+its+status%2C+and+any+scientific+reviews+of+it.\u0026amp;theme=33b2e769a9dcc417ef28c1d1\u0026amp;signature=82d6f4aeaa67904d6d25b0db2c3b7d9a50fd85b379d79b9fe3004acbddedf56c\">\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/phylo/up0yDM567jnQyYsi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Biomni Lab\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8B8E2A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.biomni.phylo.bio/api-reference/pages/get-task\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/pages/get-task.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.biomni.phylo.bio/#organization\",\"name\":\"Biomni Lab\",\"url\":\"https://docs.biomni.phylo.bio\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/phylo/mMFc9n_OTo2ELHF4/images/logo-dark.png?fit=max\u0026auto=format\u0026n=mMFc9n_OTo2ELHF4\u0026q=85\u0026s=20429d44f98211a4ac89eb66ffa32a19\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.biomni.phylo.bio#website\",\"name\":\"Biomni Lab\",\"url\":\"https://docs.biomni.phylo.bio\",\"publisher\":{\"@id\":\"https://docs.biomni.phylo.bio/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.biomni.phylo.bio/api-reference/pages/get-task#webpage\",\"url\":\"https://docs.biomni.phylo.bio/api-reference/pages/get-task\",\"name\":\"Get a task\",\"description\":\"Get a task, its status, and any scientific reviews of it.\",\"dateModified\":\"2026-10-29T00:29:42.814Z\",\"isPartOf\":{\"@id\":\"https://docs.biomni.phylo.bio#website\"},\"breadcrumb\":{\"@id\":\"https://docs.biomni.phylo.bio/api-reference/pages/get-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.biomni.phylo.bio/api-reference/pages/get-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.biomni.phylo.bio/api-reference/pages/create-project\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tasks\",\"item\":\"https://docs.biomni.phylo.bio/api-reference/pages/start-task\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get a task\",\"item\":\"https://docs.biomni.phylo.bio/api-reference/pages/get-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.biomni.phylo.bio/api-reference/pages/get-task#apireference\",\"headline\":\"Get a task\",\"name\":\"Get a task\",\"description\":\"Get a task, its status, and any scientific reviews of it.\",\"url\":\"https://docs.biomni.phylo.bio/api-reference/pages/get-task\",\"mainEntityOfPage\":{\"@id\":\"https://docs.biomni.phylo.bio/api-reference/pages/get-task#webpage\"},\"dateModified\":\"2026-10-29T00:29:42.814Z\",\"publisher\":{\"@id\":\"https://docs.biomni.phylo.bio/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.biomni.phylo.bio#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Biomni Lab\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Biomni Lab\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/pages/get-task.md","siteName":"Biomni Lab","nav":{"global":{"anchors":[{"anchor":"Slack Community","icon":"slack","href":"https://join.slack.com/t/biomnigroup/shared_invite/zt-478z7aarm-~JC0jFpGZZorug6FhcuZFA"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API","icon":"code","groups":[{"group":"Guides","pages":[{"title":"Quickstart","href":"/api/quickstart"},{"title":"Authentication","href":"/api/authentication"},{"title":"Errors","href":"/api/errors"},{"title":"Rate limits","href":"/api/rate-limits"}]},{"group":"Recipes","pages":[{"title":"Building a Python client","href":"/api/recipes/wrapping-the-api-in-python"},{"title":"Running and grading an analysis","href":"/api/recipes/running-an-analysis"},{"title":"Running batch analyses in parallel","href":"/api/recipes/batch-analysis"},{"title":"Reviewing a gene list","href":"/api/recipes/gene-list-review"}]},{"group":"API reference","pages":[{"group":"Projects","pages":[{"title":"Create a project","openapi":"api-reference/openapi.json POST /projects","href":"/api-reference/pages/create-project"},{"title":"List projects","openapi":"api-reference/openapi.json GET /projects","href":"/api-reference/pages/list-projects"},{"title":"Get a project","openapi":"api-reference/openapi.json GET /projects/{project_id}","href":"/api-reference/pages/get-project"},{"title":"Update a project","openapi":"api-reference/openapi.json PUT /projects/{project_id}","href":"/api-reference/pages/update-project"},{"title":"Delete a project","openapi":"api-reference/openapi.json DELETE /projects/{project_id}","href":"/api-reference/pages/delete-project"}]},{"group":"Tasks","icon":"flask","pages":[{"title":"Start a task","openapi":"api-reference/openapi.json POST /experimental/tasks","href":"/api-reference/pages/start-task"},{"title":"List tasks","openapi":"api-reference/openapi.json GET /experimental/tasks","description":"List a project's tasks, newest first.","href":"/api-reference/pages/list-tasks"},{"title":"Get a task","openapi":"api-reference/openapi.json GET /experimental/tasks/{task_id}","href":"/api-reference/pages/get-task"},{"title":"Delete a task","openapi":"api-reference/openapi.json DELETE /experimental/tasks/{task_id}","description":"Delete a task and its messages.","href":"/api-reference/pages/delete-task"},{"title":"Cancel a task","openapi":"api-reference/openapi.json POST /experimental/tasks/{task_id}/cancel","href":"/api-reference/pages/cancel-task"},{"title":"Run a scientific review","openapi":"api-reference/openapi.json POST /experimental/tasks/{task_id}/review","href":"/api-reference/pages/review-task"},{"title":"List task results","openapi":"api-reference/openapi.json GET /experimental/tasks/{task_id}/results","href":"/api-reference/pages/list-results"},{"title":"Download a result","openapi":"api-reference/openapi.json GET /experimental/tasks/{task_id}/results/{result_id}/download","href":"/api-reference/pages/download-result"},{"group":"Messages","pages":[{"title":"Send a message","openapi":"api-reference/openapi.json POST /experimental/tasks/{task_id}/messages","href":"/api-reference/pages/send-message"},{"title":"List messages","openapi":"api-reference/openapi.json GET /experimental/tasks/{task_id}/messages","href":"/api-reference/pages/list-messages"},{"title":"Get a message","openapi":"api-reference/openapi.json GET /experimental/tasks/{task_id}/messages/{message_id}","href":"/api-reference/pages/get-message"},{"title":"Cancel a reply","openapi":"api-reference/openapi.json POST /experimental/tasks/{task_id}/messages/{message_id}/cancel","href":"/api-reference/pages/cancel-reply"}]}]},{"group":"Skills","icon":"flask","pages":[{"title":"List skills","openapi":"api-reference/openapi.json GET /experimental/skills","href":"/api-reference/pages/list-skills"}]},{"group":"Files","icon":"flask","pages":[{"title":"Upload a file","openapi":"api-reference/openapi.json POST /experimental/files","href":"/api-reference/pages/upload-file"},{"title":"Get multipart part URLs","openapi":"api-reference/openapi.json POST /experimental/files/{file_id}/parts","href":"/api-reference/pages/get-part-urls"},{"title":"Finalize an upload","openapi":"api-reference/openapi.json POST /experimental/files/{file_id}/finalize","href":"/api-reference/pages/finalize-upload"},{"title":"List files","openapi":"api-reference/openapi.json GET /experimental/files","href":"/api-reference/pages/list-files"},{"title":"Get a file","openapi":"api-reference/openapi.json GET /experimental/files/{file_id}","href":"/api-reference/pages/get-file"},{"title":"Download a file","openapi":"api-reference/openapi.json GET /experimental/files/{file_id}/content","href":"/api-reference/pages/download-file"}]}]}]}]},"basePath":"","title":"Get a task - Biomni Lab","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}