Use paths from the layer manifest. mask/... addresses the uint32 OME-Zarr store, features/instances.parquet contains cell IDs, mask labels, geometry, and morphology, and features/markers/{marker}.parquet contains per-cell mean/median expression joined by instance_id.
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
results:read
Read and download results
Path Parameters
id
string<uuid>
required
layerId
string<uuid>
required
path
string
required
Response
Artifact bytes
The response is of type file.
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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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/getSegmentationFile","slug":"/api-reference/endpoint/getSegmentationFile","pageMetadata":{"title":"Read segmentation artifact file","openapi":"GET /samples/{id}/segmentation/{layerId}/files/{path}","description":"Read one org-scoped mask OME-Zarr, cell morphology, marker-expression, or provenance file.","href":"/api-reference/endpoint/getSegmentationFile"},"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: \"Read one org-scoped mask OME-Zarr, cell morphology, marker-expression, or provenance file.\"\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 paths from the layer manifest. `,_jsx(_components.code,{children:`mask/...`}),` addresses the uint32 OME-Zarr store, `,_jsx(_components.code,{children:`features/instances.parquet`}),` contains cell IDs, mask labels, geometry, and morphology, and `,_jsx(_components.code,{children:`features/markers/{marker}.parquet`}),` contains per-cell mean/median expression joined by `,_jsx(_components.code,{children:`instance_id`}),`.`]})}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":"Read segmentation artifact file","openapi":"GET /samples/{id}/segmentation/{layerId}/files/{path}","description":"Read one org-scoped mask OME-Zarr, cell morphology, marker-expression, or provenance file.","href":"/api-reference/endpoint/getSegmentationFile"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/strandai/a92a1cb8d942860f/posthog-pageviews.js"],"openApiReferenceData":{"operation":{"summary":"Read one segmentation artifact file","description":"Read one org-scoped mask OME-Zarr, cell morphology, marker-expression, or provenance file.","security":["3a8fd258-c457-44c2-8e12-2699509de2e2","4793f7a4-7a67-4924-b9a2-da4e15be1902"],"parameters":["7de719f0-4930-48ef-842f-0c3cd7479567","6d5b3ef5-0272-4e04-ade7-2e9fd3da98bb","3fcd5cc0-eccf-4dd9-b6c9-99e9e5fee36c"],"responses":{"200":"3ff0f893-d2e0-4009-9261-9493b7e57c10","400":"b8f9a2f9-6101-4652-a411-7f2beca3293f","401":"70f7e08d-e786-4cef-b20d-c75b2e622268","403":"0e84a9ff-803b-47d4-8649-02a81cd0dcb2","404":"c42d1391-530f-4700-84d4-55b19bd1b986","500":"5ade5c40-00af-483c-82ec-1270b734cb6a"},"method":"get","type":"path","servers":["913b60f1-f440-4231-8834-21a4f2805b1b"],"path":"/samples/{id}/segmentation/{layerId}/files/{path}","baseUrlOptions":["https://app.strandai.com/api/v1"],"title":"Read one segmentation artifact file","codeSamples":[],"requestExampleLanguages":["python","bash","javascript","php","go","java","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7de719f0-4930-48ef-842f-0c3cd7479567":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"6d5b3ef5-0272-4e04-ade7-2e9fd3da98bb":{"name":"layerId","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"3fcd5cc0-eccf-4dd9-b6c9-99e9e5fee36c":{"name":"path","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"3ff0f893-d2e0-4009-9261-9493b7e57c10":{"description":"Artifact bytes","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"b8f9a2f9-6101-4652-a411-7f2beca3293f":{"description":"Invalid artifact path","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"},"70f7e08d-e786-4cef-b20d-c75b2e622268":{"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"},"0e84a9ff-803b-47d4-8649-02a81cd0dcb2":{"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"},"c42d1391-530f-4700-84d4-55b19bd1b986":{"description":"Artifact 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"},"5ade5c40-00af-483c-82ec-1270b734cb6a":{"description":"Storage proxy failure","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":{"3a8fd258-c457-44c2-8e12-2699509de2e2":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"sk-strand-XXXXXXXXXXXXXXXXXXXXXXXX","scopes":[],"schemeName":"ApiKey"}},"4793f7a4-7a67-4924-b9a2-da4e15be1902":{"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","results: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","results: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":"Read segmentation artifact file - Strand AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-21T00:47:26.038Z","originalFileLocation":"api-reference/endpoint/getSegmentationFile.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=\"Read one org-scoped mask OME-Zarr, cell morphology, marker-expression, or provenance file.\">\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=\"Read segmentation artifact file - Strand AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read one org-scoped mask OME-Zarr, cell morphology, marker-expression, or provenance file.\">\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/getSegmentationFile\">\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=\"Read segmentation artifact file - Strand AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read one org-scoped mask OME-Zarr, cell morphology, marker-expression, or provenance file.\">\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/getSegmentationFile\">\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/getSegmentationFile.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/getSegmentationFile#webpage\",\"url\":\"https://docs.strandai.com/api-reference/endpoint/getSegmentationFile\",\"name\":\"Read segmentation artifact file\",\"description\":\"Read one org-scoped mask OME-Zarr, cell morphology, marker-expression, or provenance file.\",\"dateModified\":\"2026-08-21T00:47:26.038Z\",\"isPartOf\":{\"@id\":\"https://docs.strandai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.strandai.com/api-reference/endpoint/getSegmentationFile#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.strandai.com/api-reference/endpoint/getSegmentationFile#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.strandai.com/api-reference/endpoint/listMarkers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Read segmentation artifact file\",\"item\":\"https://docs.strandai.com/api-reference/endpoint/getSegmentationFile\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.strandai.com/api-reference/endpoint/getSegmentationFile#apireference\",\"headline\":\"Read segmentation artifact file\",\"name\":\"Read segmentation artifact file\",\"description\":\"Read one org-scoped mask OME-Zarr, cell morphology, marker-expression, or provenance file.\",\"url\":\"https://docs.strandai.com/api-reference/endpoint/getSegmentationFile\",\"mainEntityOfPage\":{\"@id\":\"https://docs.strandai.com/api-reference/endpoint/getSegmentationFile#webpage\"},\"image\":\"https://docs.strandai.com/images/og-card.png\",\"dateModified\":\"2026-08-21T00:47:26.038Z\",\"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/getSegmentationFile.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","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","href":"/api-reference/endpoint/startSampleSegmentation"},{"title":"Get segmentation manifest","openapi":"GET /samples/{id}/segmentation/{layerId}/manifest","description":"Read the mask, cell morphology/geometry, marker-expression, and provenance contract.","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","description":"Set a sample to expire on a specific date, set it to never expire, or clear any custom expiration and follow the org default. Caller must be the sample's creator, an org owner/admin, or a Strand AI admin.","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":"Read segmentation artifact file - 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"]}