Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.
Returns an owned sample with its current and historical inference jobs, or a public sample when the path id is a public share UUID. The required ownership field discriminates the two response shapes.
Authorizations
ApiKeyOAuth2
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
id
string<uuid>
required
Response
Owned or public sample detail
Option 1
Option 2
An owned sample's curated read model and its 50 newest inference jobs. jobCount is the uncapped total.
ownership
enum<string>
required
Available options:
mine
id
string<uuid>
required
appUrl
string<uri>
required
Canonical browser URL for this owned sample.
name
string | null
required
Human-friendly display name, or null if unset (falls back to filename).
filename
string
required
Original uploaded filename.
status
string
required
Lifecycle status: uploading, upload_failed, deid_running, deid_failed, preprocessing, ready, or preprocess_failed.
fileSize
string
required
Uploaded file size in bytes (string-encoded 64-bit integer).
widthPx
integer | null
required
Level-0 width in pixels, or null before the dimensions probe completes.
heightPx
integer | null
required
Level-0 height in pixels, or null before the dimensions probe completes.
mpp
number | null
required
Effective isotropic microns per pixel (user override → calibrated slide value), or null when the sample has no usable scale yet.
originalRetiredAt
string<date-time> | null
required
When original-file retirement was claimed. Null while the original remains available. Canonical H&E still supports viewing, inference and scale changes; retirement does not make the sample read-only.
fields
object
required
Unified field values keyed by stable definition key. Tags is a string array at tags; Public is a boolean at public. Values are validated against the organization's definitions.
createdAt
string<date-time> | null
required
expiresAt
string<date-time> | null
required
When the sample moves to Trash. Null when it never expires.
expiresAtSource
enum<string> | null
required
org_default = derived from the org policy at upload time. custom = set by an explicit expiration call (a date or a never-expire pin). Null when the sample has no expiration and no org policy applies.
Available options:
org_default,
custom,
null
expiresInDays
integer | null
required
Whole days until expiry, clamped at 0 for a sample at/past its date but not yet swept. Null when the sample never expires.
willExpire
boolean
required
True when the sample has an expiration date set.
trashedAt
string<date-time> | null
required
When the sample entered Trash, or null if it is still active. Trashed samples are permanently deleted 7 days after this time.
jobs
object[]
required
Maximum array length: 50
Show child attributes
jobCount
integer
required
Total inference-job count for the sample before the 50-job cap.
Required range: x >= 0
segmentation
object
required
Show child attributes
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/getSample","slug":"/api-reference/endpoint/getSample","pageMetadata":{"title":"Get an owned or public sample","openapi":"GET /samples/{id}","description":"Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.","href":"/api-reference/endpoint/getSample"},"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: \"Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.\"\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:[`Returns an owned sample with its current and historical inference jobs, or a public sample when the path id is a public share UUID. The required `,_jsx(_components.code,{children:`ownership`}),` field discriminates the two response shapes.`]})}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":"Get an owned or public sample","openapi":"GET /samples/{id}","description":"Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.","href":"/api-reference/endpoint/getSample"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/strandai/a92a1cb8d942860f/posthog-pageviews.js"],"openApiReferenceData":{"operation":{"summary":"Get an owned or public sample","description":"Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.","parameters":["176f2b26-c1c3-4dcb-b733-3b8abffcc69b"],"responses":{"200":"dd8d550b-1de8-4dd4-94ff-a315244fa3ab","401":"f8698ad6-8e08-4946-832b-6943289b1c59","404":"a031a36f-95f0-45cc-baf0-c40510812aac"},"method":"get","type":"path","servers":["913b60f1-f440-4231-8834-21a4f2805b1b"],"security":["60628517-0418-48b4-a0e8-57e66957d887","635144bc-1dfa-4dbd-8d63-d6395c5732c6"],"path":"/samples/{id}","baseUrlOptions":["https://app.strandai.com/api/v1"],"title":"Get an owned or public sample","codeSamples":[],"requestExampleLanguages":["python","bash","javascript","php","go","java","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"176f2b26-c1c3-4dcb-b733-3b8abffcc69b":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"dd8d550b-1de8-4dd4-94ff-a315244fa3ab":{"description":"Owned or public sample detail","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"An owned sample's curated read model and its 50 newest inference jobs. `jobCount` is the uncapped total.","required":["ownership","id","appUrl","name","filename","status","fileSize","widthPx","heightPx","mpp","originalRetiredAt","fields","createdAt","expiresAt","expiresAtSource","expiresInDays","willExpire","trashedAt","jobs","jobCount","segmentation"],"properties":{"ownership":{"type":"string","enum":["mine"],"isRequired":true,"uniqueKey":"oneOf.0.ownership","typeLabel":"enum\u003cstring>"},"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string\u003cuuid>"},"appUrl":{"type":"string","format":"uri","description":"Canonical browser URL for this owned sample.","isRequired":true,"uniqueKey":"oneOf.0.appUrl","typeLabel":"string\u003curi>"},"name":{"oneOf":[{"type":"string","description":"Human-friendly display name, or null if unset (falls back to filename).","isRequired":true,"uniqueKey":"oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-friendly display name, or null if unset (falls back to filename).","isRequired":true,"uniqueKey":"oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.name","typeLabel":"string | null"},"filename":{"type":"string","description":"Original uploaded filename.","isRequired":true,"uniqueKey":"oneOf.0.filename","typeLabel":"string"},"status":{"type":"string","description":"Lifecycle status: `uploading`, `upload_failed`, `deid_running`, `deid_failed`, `preprocessing`, `ready`, or `preprocess_failed`.","isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"string"},"fileSize":{"type":"string","description":"Uploaded file size in bytes (string-encoded 64-bit integer).","isRequired":true,"uniqueKey":"oneOf.0.fileSize","typeLabel":"string"},"widthPx":{"oneOf":[{"type":"integer","description":"Level-0 width in pixels, or null before the dimensions probe completes.","isRequired":true,"uniqueKey":"oneOf.0.widthPx.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Level-0 width in pixels, or null before the dimensions probe completes.","isRequired":true,"uniqueKey":"oneOf.0.widthPx.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.widthPx","typeLabel":"integer | null"},"heightPx":{"oneOf":[{"type":"integer","description":"Level-0 height in pixels, or null before the dimensions probe completes.","isRequired":true,"uniqueKey":"oneOf.0.heightPx.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Level-0 height in pixels, or null before the dimensions probe completes.","isRequired":true,"uniqueKey":"oneOf.0.heightPx.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.heightPx","typeLabel":"integer | null"},"mpp":{"oneOf":[{"type":"number","description":"Effective isotropic microns per pixel (user override → calibrated slide value), or null when the sample has no usable scale yet.","isRequired":true,"uniqueKey":"oneOf.0.mpp.oneOf.0","typeLabel":"number"},{"type":"null","description":"Effective isotropic microns per pixel (user override → calibrated slide value), or null when the sample has no usable scale yet.","isRequired":true,"uniqueKey":"oneOf.0.mpp.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.mpp","typeLabel":"number | null"},"originalRetiredAt":{"oneOf":[{"type":"string","format":"date-time","description":"When original-file retirement was claimed. Null while the original remains available. Canonical H\u0026E still supports viewing, inference and scale changes; retirement does not make the sample read-only.","isRequired":true,"uniqueKey":"oneOf.0.originalRetiredAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When original-file retirement was claimed. Null while the original remains available. Canonical H\u0026E still supports viewing, inference and scale changes; retirement does not make the sample read-only.","isRequired":true,"uniqueKey":"oneOf.0.originalRetiredAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.originalRetiredAt","typeLabel":"string\u003cdate-time> | null"},"fields":{"type":"object","additionalProperties":true,"description":"Unified field values keyed by stable definition key. Tags is a string array at `tags`; Public is a boolean at `public`. Values are validated against the organization's definitions.","isRequired":true,"uniqueKey":"oneOf.0.fields","typeLabel":"object"},"createdAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.createdAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.createdAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.createdAt","typeLabel":"string\u003cdate-time> | null"},"expiresAt":{"oneOf":[{"type":"string","format":"date-time","description":"When the sample moves to Trash. Null when it never expires.","isRequired":true,"uniqueKey":"oneOf.0.expiresAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the sample moves to Trash. Null when it never expires.","isRequired":true,"uniqueKey":"oneOf.0.expiresAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.expiresAt","typeLabel":"string\u003cdate-time> | null"},"expiresAtSource":{"oneOf":[{"type":"string","enum":["org_default","custom",null],"description":"`org_default` = derived from the org policy at upload time. `custom` = set by an explicit expiration call (a date or a never-expire pin). Null when the sample has no expiration and no org policy applies.","isRequired":true,"uniqueKey":"oneOf.0.expiresAtSource.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["org_default","custom",null],"description":"`org_default` = derived from the org policy at upload time. `custom` = set by an explicit expiration call (a date or a never-expire pin). Null when the sample has no expiration and no org policy applies.","isRequired":true,"uniqueKey":"oneOf.0.expiresAtSource.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.expiresAtSource","typeLabel":"enum\u003cstring> | null"},"expiresInDays":{"oneOf":[{"type":"integer","description":"Whole days until expiry, clamped at 0 for a sample at/past its date but not yet swept. Null when the sample never expires.","isRequired":true,"uniqueKey":"oneOf.0.expiresInDays.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Whole days until expiry, clamped at 0 for a sample at/past its date but not yet swept. Null when the sample never expires.","isRequired":true,"uniqueKey":"oneOf.0.expiresInDays.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.expiresInDays","typeLabel":"integer | null"},"willExpire":{"type":"boolean","description":"True when the sample has an expiration date set.","isRequired":true,"uniqueKey":"oneOf.0.willExpire","typeLabel":"boolean"},"trashedAt":{"oneOf":[{"type":"string","format":"date-time","description":"When the sample entered Trash, or null if it is still active. Trashed samples are permanently deleted 7 days after this time.","isRequired":true,"uniqueKey":"oneOf.0.trashedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the sample entered Trash, or null if it is still active. Trashed samples are permanently deleted 7 days after this time.","isRequired":true,"uniqueKey":"oneOf.0.trashedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.trashedAt","typeLabel":"string\u003cdate-time> | null"},"jobs":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["id","appUrl","status","progress","reservedCredits","markers","createdAt","startedAt","completedAt","errorMessage","resultsAvailable"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"appUrl":{"type":"string","format":"uri","description":"Canonical authenticated Platform URL for this job's sample.","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].appUrl","typeLabel":"string\u003curi>"},"status":{"type":"string","description":"Lifecycle: `queued` → `dispatching` → `preprocessing` → `running` → `postprocessing` → terminal. Terminal values: `completed`, `partial_failed`, `failed`, and `cancelled`.","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].status","typeLabel":"string"},"progress":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].progress.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].progress.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].progress","typeLabel":"number | null"},"reservedCredits":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].reservedCredits.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].reservedCredits.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].reservedCredits","typeLabel":"integer | null"},"markers":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.jobs.items.[INDEX].markers.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].markers","typeLabel":"string[]"},"createdAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].createdAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].createdAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time> | null"},"startedAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].startedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].startedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].startedAt","typeLabel":"string\u003cdate-time> | null"},"completedAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].completedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].completedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].completedAt","typeLabel":"string\u003cdate-time> | null"},"errorMessage":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].errorMessage.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].errorMessage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].errorMessage","typeLabel":"string | null"},"resultsAvailable":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.0.jobs.items.[INDEX].resultsAvailable","typeLabel":"boolean"}},"uniqueKey":"oneOf.0.jobs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.jobs","typeLabel":"object[]"},"jobCount":{"type":"integer","minimum":0,"description":"Total inference-job count for the sample before the 50-job cap.","isRequired":true,"uniqueKey":"oneOf.0.jobCount","typeLabel":"integer"},"segmentation":{"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":"oneOf.0.segmentation.status","typeLabel":"enum\u003cstring>"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.0.segmentation.retryable","typeLabel":"boolean"},"creditCost":{"type":"integer","enum":[0],"description":"Segmentation is credit-free.","isRequired":true,"uniqueKey":"oneOf.0.segmentation.creditCost","typeLabel":"enum\u003cinteger>"},"job":{"oneOf":[{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"oneOf.0.segmentation.job.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"isRequired":true,"uniqueKey":"oneOf.0.segmentation.job.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.segmentation.job","typeLabel":"object | null"},"layer":{"oneOf":[{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"oneOf.0.segmentation.layer.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"isRequired":true,"uniqueKey":"oneOf.0.segmentation.layer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.segmentation.layer","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"oneOf.0.segmentation","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"A public sample's curated detail. `id` is the public share UUID; the internal sample identity and job history are never exposed.","required":["ownership","id","appUrl","title","thumbnailUrl","geometry","viewer"],"properties":{"ownership":{"type":"string","enum":["public"],"isRequired":true,"uniqueKey":"oneOf.1.ownership","typeLabel":"enum\u003cstring>"},"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string\u003cuuid>"},"appUrl":{"type":"string","format":"uri","description":"Canonical browser URL for this public sample.","isRequired":true,"uniqueKey":"oneOf.1.appUrl","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.title","typeLabel":"string"},"thumbnailUrl":{"type":"string","description":"v1-relative path to the sample's JPEG thumbnail.","isRequired":true,"uniqueKey":"oneOf.1.thumbnailUrl","typeLabel":"string"},"geometry":{"type":"object","required":["widthPx","heightPx","mppX","mppY"],"description":"Level-0 pixel dimensions and microns-per-pixel of the H\u0026E image.","properties":{"widthPx":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.geometry.widthPx","typeLabel":"integer"},"heightPx":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.geometry.heightPx","typeLabel":"integer"},"mppX":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"oneOf.1.geometry.mppX.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.1.geometry.mppX.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.geometry.mppX","typeLabel":"number | null"},"mppY":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"oneOf.1.geometry.mppY.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.1.geometry.mppY.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.geometry.mppY","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"oneOf.1.geometry","typeLabel":"object"},"viewer":{"type":"object","required":["pyramidUrl","markers"],"description":"How to read the pixel data: the OME-Zarr pyramid base path and the marker channels it carries.","properties":{"pyramidUrl":{"type":"string","description":"v1-relative base path of the OME-Zarr store (`GET /public/samples/{publicId}/zarr/{...path}`). The root manifest is `{pyramidUrl}/zarr.json`.","isRequired":true,"uniqueKey":"oneOf.1.viewer.pyramidUrl","typeLabel":"string"},"markers":{"type":"array","description":"Live marker channels available in the pyramid.","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.viewer.markers.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"oneOf.1.viewer.markers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.viewer.markers","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"oneOf.1.viewer","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ownership":"mine","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","appUrl":"\u003cstring>","name":"\u003cstring>","filename":"\u003cstring>","status":"\u003cstring>","fileSize":"\u003cstring>","widthPx":123,"heightPx":123,"mpp":123,"originalRetiredAt":"2023-11-07T05:31:56Z","fields":{},"createdAt":"2023-11-07T05:31:56Z","expiresAt":"2023-11-07T05:31:56Z","expiresAtSource":"org_default","expiresInDays":123,"willExpire":true,"trashedAt":"2023-11-07T05:31:56Z","jobs":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","appUrl":"\u003cstring>","status":"\u003cstring>","progress":123,"reservedCredits":123,"markers":["\u003cstring>"],"createdAt":"2023-11-07T05:31:56Z","startedAt":"2023-11-07T05:31:56Z","completedAt":"2023-11-07T05:31:56Z","errorMessage":"\u003cstring>","resultsAvailable":true}],"jobCount":1,"segmentation":{"status":"not_started","retryable":true,"creditCost":0,"job":{},"layer":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"f8698ad6-8e08-4946-832b-6943289b1c59":{"description":"Missing or invalid API key","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"},"a031a36f-95f0-45cc-baf0-c40510812aac":{"description":"Sample not found in this org","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":{"60628517-0418-48b4-a0e8-57e66957d887":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"sk-strand-XXXXXXXXXXXXXXXXXXXXXXXX","scopes":[],"schemeName":"ApiKey"}},"635144bc-1dfa-4dbd-8d63-d6395c5732c6":{"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":[],"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":[],"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":"Get an owned or public sample - Strand AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-20T00:53:04.027Z","originalFileLocation":"api-reference/endpoint/getSample.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=\"Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.\">\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=\"Get an owned or public sample - Strand AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.\">\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/getSample\">\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=\"Get an owned or public sample - Strand AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.\">\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/getSample\">\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/getSample.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/getSample#webpage\",\"url\":\"https://docs.strandai.com/api-reference/endpoint/getSample\",\"name\":\"Get an owned or public sample\",\"description\":\"Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.\",\"dateModified\":\"2026-08-20T00:53:04.027Z\",\"isPartOf\":{\"@id\":\"https://docs.strandai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.strandai.com/api-reference/endpoint/getSample#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.strandai.com/api-reference/endpoint/getSample#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.strandai.com/api-reference/endpoint/listMarkers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get an owned or public sample\",\"item\":\"https://docs.strandai.com/api-reference/endpoint/getSample\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.strandai.com/api-reference/endpoint/getSample#apireference\",\"headline\":\"Get an owned or public sample\",\"name\":\"Get an owned or public sample\",\"description\":\"Resolve an org-owned sample id first, returning its curated detail and inference-job history. Otherwise resolve the same path value as a currently-public share UUID and return only public-safe detail.\",\"url\":\"https://docs.strandai.com/api-reference/endpoint/getSample\",\"mainEntityOfPage\":{\"@id\":\"https://docs.strandai.com/api-reference/endpoint/getSample#webpage\"},\"image\":\"https://docs.strandai.com/images/og-card.png\",\"dateModified\":\"2026-08-20T00:53:04.027Z\",\"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/getSample.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","description":"Returns single-object signed GET capabilities for raw stored result objects only, never decoded inner chunks or prefix access. All paths must pass the same organization, sample, readiness and delivered-marker gates as batch reads. Only zarr.json, _marker_frame.json, he/ and delivered markers/ paths are accepted. Duplicate paths are deduplicated in first-requested order. At most 16 paths, 64 MiB per object and 64 MiB total; all authorization, metadata and budget checks precede signing. The server fixes a common expiry no later than 120 seconds after preflight; provider credential expiry or object deletion can make a capability unusable sooner. URLs are replayable bearer secrets until effective expiry, not single-use or application-revocable. Changing API access does not revoke an issued URL. Direct storage reads incur provider requests/egress and bypass application read-byte accounting. No client storage credentials are required. A signed whole-object URL does not restrict the recipient to a Range. objectId is SHA-256 of compact UTF-8 JSON [provider,bucket,canonicalKey,version], an identity hash, NOT a content checksum. Checksums are provider base64 when available; ETag is opaque.","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}","description":"Atomically update any combination of an owned sample's display name, unified field values, and isotropic microns-per-pixel value. Public share ids are not patchable. OAuth callers need both `samples:read` and `samples:write` because the response includes full owned detail and job history. When countable `mpp` is supplied, an idempotent recount is enqueued even if the stored value is unchanged; after an enqueue-failure 500, retry the identical patch to heal the recount.","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","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":"Get an owned or public sample - 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"]}