Use POST on the same path to start or retry segmentation. The mutation is state-idempotent, observes a retry cooldown, and rejects public sample handles. Completed layers expose a separate manifest for uint32 masks, cell geometry/morphology, and per-cell marker expression.
Authorizations
ApiKeyOAuth2
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Scopes
samples:read
Read slide metadata and estimates
Path Parameters
id
string<uuid>
required
Response
Lifecycle state
status
enum<string>
required
Available options:
not_started,
queued,
running,
postprocessing,
completed,
failed,
cancelled
retryable
boolean
required
creditCost
enum<integer>
required
Segmentation is credit-free.
Available options:
0
job
object | null
required
layer
object | null
required
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Strand AI","description":"Spatial proteomics from H\u0026E. Lattice predicts spatially resolved protein-marker maps from routine H\u0026E, delivered as virtual mIF channels.","colors":{"primary":"#004D3B","light":"#006650","dark":"#004D3B"},"logo":{"light":"https://mintcdn.com/strandai/c6Te5vUWVWP-mr0Q/logo-dark.svg?fit=max\u0026auto=format\u0026n=c6Te5vUWVWP-mr0Q\u0026q=85\u0026s=689c0d47abf0f9b5076e963acaffa8d6","dark":"https://mintcdn.com/strandai/c6Te5vUWVWP-mr0Q/logo-white.svg?fit=max\u0026auto=format\u0026n=c6Te5vUWVWP-mr0Q\u0026q=85\u0026s=40bf5ca332d513c816780709e94b8c16","href":"https://strandai.com"},"favicon":"https://mintcdn.com/strandai/vTcOY54DE0LzRJ_f/favicon.svg?fit=max\u0026auto=format\u0026n=vTcOY54DE0LzRJ_f\u0026q=85\u0026s=20b05705652e3edd7ffcd411efa9417b","api":{"openapi":"api-reference/openapi.json","examples":{"languages":["python","curl","javascript","php","go","java","ruby"]}},"background":{"color":{"light":"#F2F1ED","dark":"#00120A"}},"navbar":{"links":[{"href":"mailto:support@strandai.com","label":"Support"}],"primary":{"type":"button","label":"Platform","href":"https://app.strandai.com"}},"footer":{"socials":{"website":"https://strandai.com","github":"https://github.com/strand-ai"}},"seo":{"metatags":{"og:site_name":"Strand AI Docs","og:type":"website","og:image":"https://docs.strandai.com/images/og-card.png","twitter:image":"https://docs.strandai.com/images/og-card.png","twitter:card":"summary_large_image"},"indexing":"all"},"fonts":{"heading":{"family":"PP Telegraf","weight":400,"source":"fonts/PPTelegraf-Regular.woff2","format":"woff2"},"body":{"family":"Source Sans 3"}},"styling":{"codeblocks":"dark","latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"strandai","hasAudioNarration":false,"actualSubdomain":"strandai","customDomains":["docs.strandai.com"],"gitSource":{"type":"github","owner":"strand-ai","repo":"strand-official","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b010b22d15ec117daff2f0f","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":35},{"language":"default","tag":"Endpoints","count":34},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"SDKs","count":4},{"language":"default","tag":"Programmatic workflows","count":4},{"language":"default","tag":"Plan a run","count":3},{"language":"default","tag":"MCP","count":3},{"language":"default","tag":"Connect an agent","count":3},{"language":"default","tag":"Manage and explore","count":2},{"language":"default","tag":"Get started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"api-reference/endpoint/sampleSegmentation","slug":"/api-reference/endpoint/sampleSegmentation","pageMetadata":{"title":"Cell segmentation lifecycle","openapi":"GET /samples/{id}/segmentation","description":"Discover credit-free segmentation state and latest layer artifacts for an owned sample.","href":"/api-reference/endpoint/sampleSegmentation"},"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: \"Discover credit-free segmentation state and latest layer artifacts for an owned sample.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`POST`}),` on the same path to start or retry segmentation. The mutation is state-idempotent, observes a retry cooldown, and rejects public sample handles. Completed layers expose a separate manifest for uint32 masks, cell geometry/morphology, and per-cell marker expression.`]})}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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Cell segmentation lifecycle","openapi":"GET /samples/{id}/segmentation","description":"Discover credit-free segmentation state and latest layer artifacts for an owned sample.","href":"/api-reference/endpoint/sampleSegmentation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/strandai/a92a1cb8d942860f/posthog-pageviews.js"],"openApiReferenceData":{"operation":{"summary":"Get cell-segmentation lifecycle","description":"Discover credit-free segmentation state and latest layer artifacts for an owned sample.","security":["bb9d2354-1c7d-4c26-8e38-51a43c587b8c","e66b987a-d6fb-48c8-a331-fdb0b4b1da09"],"parameters":["453679ed-d617-400a-a134-da5e766e6e7f"],"responses":{"200":"4f7fe7f8-c5c6-40e2-bec3-1df6b192632b","401":"7be77139-a2cf-412e-b59f-7471bb02533b","403":"ee4fede9-7216-4ad4-9b55-b65bdf055421","404":"c16a0270-fbb6-4be6-af9a-6824314fc368"},"method":"get","type":"path","servers":["913b60f1-f440-4231-8834-21a4f2805b1b"],"path":"/samples/{id}/segmentation","baseUrlOptions":["https://app.strandai.com/api/v1"],"title":"Get cell-segmentation lifecycle","codeSamples":[],"requestExampleLanguages":["python","bash","javascript","php","go","java","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"453679ed-d617-400a-a134-da5e766e6e7f":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"4f7fe7f8-c5c6-40e2-bec3-1df6b192632b":{"description":"Lifecycle state","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status","retryable","creditCost","job","layer"],"properties":{"status":{"type":"string","enum":["not_started","queued","running","postprocessing","completed","failed","cancelled"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"creditCost":{"type":"integer","enum":[0],"description":"Segmentation is credit-free.","isRequired":true,"uniqueKey":"creditCost","typeLabel":"enum\u003cinteger>"},"job":{"oneOf":[{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"job.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"isRequired":true,"uniqueKey":"job.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"job","typeLabel":"object | null"},"layer":{"oneOf":[{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"layer.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"isRequired":true,"uniqueKey":"layer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"layer","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"not_started","retryable":true,"creditCost":0,"job":{},"layer":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"7be77139-a2cf-412e-b59f-7471bb02533b":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"required":{"oneOf":[{"type":"integer","uniqueKey":"required.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"required.oneOf.1","typeLabel":"null"}],"uniqueKey":"required","typeLabel":"integer | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","reason":"\u003cstring>","required":123,"retryAfterSeconds":123}}},"exampleType":"generated"}},"exampleType":"generated"},"ee4fede9-7216-4ad4-9b55-b65bdf055421":{"description":"OAuth token lacks a required scope","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"required":{"oneOf":[{"type":"integer","uniqueKey":"required.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"required.oneOf.1","typeLabel":"null"}],"uniqueKey":"required","typeLabel":"integer | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","reason":"\u003cstring>","required":123,"retryAfterSeconds":123}}},"exampleType":"generated"}},"exampleType":"generated"},"c16a0270-fbb6-4be6-af9a-6824314fc368":{"description":"Owned sample not found","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","uniqueKey":"reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"reason","typeLabel":"string | null"},"required":{"oneOf":[{"type":"integer","uniqueKey":"required.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"required.oneOf.1","typeLabel":"null"}],"uniqueKey":"required","typeLabel":"integer | null"},"retryAfterSeconds":{"oneOf":[{"type":"integer","uniqueKey":"retryAfterSeconds.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"retryAfterSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"retryAfterSeconds","typeLabel":"integer | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","reason":"\u003cstring>","required":123,"retryAfterSeconds":123}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bb9d2354-1c7d-4c26-8e38-51a43c587b8c":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"sk-strand-XXXXXXXXXXXXXXXXXXXXXXXX","scopes":[],"schemeName":"ApiKey"}},"e66b987a-d6fb-48c8-a331-fdb0b4b1da09":{"OAuth2":{"type":"oauth2","description":"Strand AI authorization-code flow with S256 PKCE, explicit organization consent, and RFC 8707 resource binding.","flows":{"authorizationCode":{"authorizationUrl":"https://auth.strandai.com/oauth2/auth","tokenUrl":"https://auth.strandai.com/oauth2/token","scopes":{"samples:read":"Read slide metadata and estimates","samples:write":"Upload and change slides","jobs:read":"Read run status","jobs:write":"Start, export, or cancel runs","results:read":"Read and download results","credits:spend":"Reserve and spend organization credits"}}},"scopes":["samples:read"],"schemeName":"OAuth2"}}},"servers":{"913b60f1-f440-4231-8834-21a4f2805b1b":{"url":"https://app.strandai.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"sk-strand-XXXXXXXXXXXXXXXXXXXXXXXX","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"},{"schemes":[{"scheme":{"type":"oauth2","description":"Strand AI authorization-code flow with S256 PKCE, explicit organization consent, and RFC 8707 resource binding.","flows":{"authorizationCode":{"authorizationUrl":"https://auth.strandai.com/oauth2/auth","tokenUrl":"https://auth.strandai.com/oauth2/token","scopes":{"samples:read":"Read slide metadata and estimates","samples:write":"Upload and change slides","jobs:read":"Read run status","jobs:write":"Start, export, or cancel runs","results:read":"Read and download results","credits:spend":"Reserve and spend organization credits"}}},"scopes":["samples:read"],"schemeName":"OAuth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"Strand AI authorization-code flow with S256 PKCE, explicit organization consent, and RFC 8707 resource binding.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth2","name":"Authorization"}],"title":"OAuth2"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"strandai","siteName":"Strand AI","title":"Cell segmentation lifecycle - Strand AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-21T00:47:26.032Z","originalFileLocation":"api-reference/endpoint/sampleSegmentation.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=\"Discover credit-free segmentation state and latest layer artifacts for an owned sample.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Strand AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/strandai/-A6LhR9Q97KZhsDo/_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/strandai/-A6LhR9Q97KZhsDo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/strandai/-A6LhR9Q97KZhsDo/_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/strandai/-A6LhR9Q97KZhsDo/_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/strandai/-A6LhR9Q97KZhsDo/_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/strandai/-A6LhR9Q97KZhsDo/_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/strandai/-A6LhR9Q97KZhsDo/_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/strandai/-A6LhR9Q97KZhsDo/_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/strandai/-A6LhR9Q97KZhsDo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Cell segmentation lifecycle - Strand AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Discover credit-free segmentation state and latest layer artifacts for an owned sample.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Strand AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.strandai.com/images/og-card.png\">\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=\"Cell segmentation lifecycle - Strand AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Discover credit-free segmentation state and latest layer artifacts for an owned sample.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.strandai.com/images/og-card.png\">\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/strandai/-A6LhR9Q97KZhsDo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Strand AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#004D3B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/sampleSegmentation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.strandai.com/#organization\",\"name\":\"Strand AI\",\"url\":\"https://docs.strandai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/strandai/c6Te5vUWVWP-mr0Q/logo-dark.svg?fit=max\u0026auto=format\u0026n=c6Te5vUWVWP-mr0Q\u0026q=85\u0026s=689c0d47abf0f9b5076e963acaffa8d6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.strandai.com#website\",\"name\":\"Strand AI\",\"url\":\"https://docs.strandai.com\",\"publisher\":{\"@id\":\"https://docs.strandai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation#webpage\",\"url\":\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation\",\"name\":\"Cell segmentation lifecycle\",\"description\":\"Discover credit-free segmentation state and latest layer artifacts for an owned sample.\",\"dateModified\":\"2026-08-21T00:47:26.032Z\",\"isPartOf\":{\"@id\":\"https://docs.strandai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.strandai.com/api-reference/endpoint/listMarkers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Cell segmentation lifecycle\",\"item\":\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation#apireference\",\"headline\":\"Cell segmentation lifecycle\",\"name\":\"Cell segmentation lifecycle\",\"description\":\"Discover credit-free segmentation state and latest layer artifacts for an owned sample.\",\"url\":\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.strandai.com/api-reference/endpoint/sampleSegmentation#webpage\"},\"image\":\"https://docs.strandai.com/images/og-card.png\",\"dateModified\":\"2026-08-21T00:47:26.032Z\",\"publisher\":{\"@id\":\"https://docs.strandai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.strandai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Strand AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Strand AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/sampleSegmentation.md","siteName":"Strand AI","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/quickstart"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"REST API overview","href":"/api/overview"}]},{"group":"Endpoints","pages":[{"title":"List markers","openapi":"GET /markers","href":"/api-reference/endpoint/listMarkers"},{"title":"List uploads","openapi":"GET /uploads","href":"/api-reference/endpoint/listUploads"},{"title":"Get an upload","openapi":"GET /uploads/{id}","href":"/api-reference/endpoint/getUpload"},{"title":"Initiate upload","openapi":"POST /uploads","href":"/api-reference/endpoint/createUpload"},{"title":"Renew an upload session","openapi":"POST /uploads/{id}","href":"/api-reference/endpoint/renewUploadSession"},{"title":"Complete an upload","openapi":"POST /uploads/{id}/complete","href":"/api-reference/endpoint/completeUpload"},{"title":"Price or submit a prediction","openapi":"POST /predict","href":"/api-reference/endpoint/submitPrediction"},{"title":"Get job","openapi":"GET /jobs/{id}","href":"/api-reference/endpoint/getJob"},{"title":"Cancel a job","openapi":"POST /jobs/{id}/cancel","href":"/api-reference/endpoint/cancelJob"},{"title":"Stream job (SSE)","openapi":"GET /jobs/{id}/stream","href":"/api-reference/endpoint/streamJob"},{"title":"Get results URL","openapi":"GET /jobs/{id}/results","href":"/api-reference/endpoint/getJobResults"},{"title":"Download result file","openapi":"GET /jobs/{id}/results/files/{path}","href":"/api-reference/endpoint/getJobResultFile"},{"title":"Read result files in a batch","openapi":"POST /jobs/{id}/results/files","href":"/api-reference/endpoint/getJobResultFilesBatch"},{"title":"Preflight signed result files","openapi":"POST /jobs/{id}/results/files/signed","href":"/api-reference/endpoint/getSignedJobResultFiles"},{"title":"Get an owned or public sample","openapi":"GET /samples/{id}","href":"/api-reference/endpoint/getSample"},{"title":"Update a sample","openapi":"PATCH /samples/{id}","href":"/api-reference/endpoint/patchSample"},{"title":"Request result export","openapi":"POST /jobs/{id}/exports","href":"/api-reference/endpoint/requestResultExport"},{"title":"Get result export","openapi":"GET /jobs/{id}/exports","description":"Poll a format-driven result export and refresh expiring artifact URLs.","href":"/api-reference/endpoint/getResultExport"},{"title":"Cell segmentation lifecycle","openapi":"GET /samples/{id}/segmentation","href":"/api-reference/endpoint/sampleSegmentation"},{"title":"Start or retry cell segmentation","openapi":"POST /samples/{id}/segmentation","description":"Start or retry idempotent, credit-free segmentation for an owned ready sample.","href":"/api-reference/endpoint/startSampleSegmentation"},{"title":"Get segmentation manifest","openapi":"GET /samples/{id}/segmentation/{layerId}/manifest","href":"/api-reference/endpoint/getSegmentationManifest"},{"title":"Read segmentation artifact file","openapi":"GET /samples/{id}/segmentation/{layerId}/files/{path}","href":"/api-reference/endpoint/getSegmentationFile"},{"title":"Set sample expiration","openapi":"PATCH /samples/{id}/expiration","href":"/api-reference/endpoint/setSampleExpiration"},{"title":"Set sample expiration (bulk)","openapi":"PATCH /samples/expiration","href":"/api-reference/endpoint/setSamplesExpirationBulk"},{"title":"Restore sample","openapi":"POST /samples/{id}/restore","href":"/api-reference/endpoint/restoreSample"},{"title":"List samples","openapi":"GET /samples","href":"/api-reference/endpoint/listSamples"},{"title":"List custom sample fields","openapi":"GET /sample-fields","href":"/api-reference/endpoint/listSampleFields"},{"title":"Create a custom sample field","openapi":"POST /sample-fields","href":"/api-reference/endpoint/createSampleField"},{"title":"Publish an artifact","openapi":"POST /artifacts","href":"/api-reference/endpoint/createArtifact"},{"title":"List artifacts","openapi":"GET /artifacts","href":"/api-reference/endpoint/listArtifacts"},{"title":"Get an artifact","openapi":"GET /artifacts/{id}","href":"/api-reference/endpoint/getArtifact"},{"title":"Delete an artifact","openapi":"DELETE /artifacts/{id}","href":"/api-reference/endpoint/deleteArtifact"},{"title":"Stream a public sample's OME-Zarr","openapi":"GET /public/samples/{publicId}/zarr/{path}","href":"/api-reference/endpoint/getPublicSampleZarr"},{"title":"Get a public sample thumbnail","openapi":"GET /public/samples/{publicId}/thumbnail","href":"/api-reference/endpoint/getPublicSampleThumbnail"}]}]}]},"basePath":"","title":"Cell segmentation lifecycle - Strand AI","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}