Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional.
Seed Video Replacement Policy:
If seedVideoUrl is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns 409 Conflict) to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database.
On an ACTIVE sample, replacing the seed may demote the sample to DRAFT and disable collab/public flags until the new seed is re-validated.
Optional public HTTPS URL of a new seed video. YPH securely ingests and validates the file. Echoed in responses; use signedSeedVideoUrl to preview. Pass null to clear the seed.
seedVideoDurationSec
integer | null
Optional duration in seconds for the replaced seed (must be 170 seconds or less).
Required range: x <= 170
accountToken
string | null
Optional updated brand accountToken (pass null to clear).
Maximum string length: 128
productToken
string | null
Optional updated catalog productToken (pass null to clear).
Maximum string length: 128
Response
Updated successfully
digitalSample
object
Digital sample resource returned by GET, POST, and PATCH.
Write-only (POST/PATCH body):seedVideoUrl — your public HTTPS source URL. YPH ingests a copy into private storage. Use the presigned upload flow (/seed/upload-url + /seed/register) when uploading directly.
Read-only (responses):signedSeedVideoUrl — short-lived presigned GET URL for preview/download. Never send this back on PATCH.
Echo (responses):seedVideoUrl repeats the external source URL you submitted (null when the seed was uploaded via presigned PUT or created in the YPH app).
Integrator identity:accountToken identifies the brand (your marketplace advertiser). productToken is your internal catalog product id. See Integrator tokens.
Credits: Org credit balance is not on this resource — use GET /account (creditBalance).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Your Product Here API","colors":{"primary":"#8b5cf6","light":"#a78bfa","dark":"#7c3aed"},"logo":{"light":"https://mintcdn.com/yphai/4tKX1GeDxYXfYG9B/logo.webp?fit=max\u0026auto=format\u0026n=4tKX1GeDxYXfYG9B\u0026q=85\u0026s=b4d155d7687a9237366e89f3d8a8e04f","dark":"https://mintcdn.com/yphai/4tKX1GeDxYXfYG9B/logo.webp?fit=max\u0026auto=format\u0026n=4tKX1GeDxYXfYG9B\u0026q=85\u0026s=b4d155d7687a9237366e89f3d8a8e04f","href":"https://yourproducthere.ai"},"favicon":"https://mintcdn.com/yphai/4tKX1GeDxYXfYG9B/logo.webp?fit=max\u0026auto=format\u0026n=4tKX1GeDxYXfYG9B\u0026q=85\u0026s=b4d155d7687a9237366e89f3d8a8e04f","navbar":{"links":[{"href":"https://yourproducthere.ai","label":"Home"},{"href":"https://yourproducthere.ai/app/developer","label":"Developer app"},{"href":"https://yourproducthere.ai/credentials","label":"Credentials"}],"primary":{"type":"button","label":"Sign in","href":"https://yourproducthere.ai/auth?returnTo=%2Fapp%2Fdashboard"}},"footer":{"socials":{"website":"https://yourproducthere.ai","linkedin":"https://www.linkedin.com/in/michelpadron"},"links":[{"header":"App","items":[{"label":"Sign in","href":"https://yourproducthere.ai/auth?returnTo=%2Fapp%2Fdashboard"},{"label":"Dashboard","href":"https://yourproducthere.ai/app/dashboard"},{"label":"Developer (keys \u0026 webhooks)","href":"https://yourproducthere.ai/app/developer"}]},{"header":"Product","items":[{"label":"Home","href":"https://yourproducthere.ai"},{"label":"How it works","href":"https://yourproducthere.ai/"},{"label":"Benchmarks","href":"https://yourproducthere.ai/experimental"}]},{"header":"Company","items":[{"label":"Who we serve","href":"https://yourproducthere.ai/who-we-serve"},{"label":"Credentials","href":"https://yourproducthere.ai/credentials"},{"label":"About","href":"https://yourproducthere.ai/about"},{"label":"Enterprise API (marketing)","href":"https://yourproducthere.ai/use-cases/enterprise-b2b-api"},{"label":"Enterprise installation guide","href":"https://docs.yourproducthere.ai/guides/enterprise-installation"}]},{"header":"Legal","items":[{"label":"Terms","href":"https://yourproducthere.ai/terms"},{"label":"Privacy","href":"https://yourproducthere.ai/privacy"}]}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"yphai","hasAudioNarration":false,"actualSubdomain":"yphai","customDomains":["docs.yourproducthere.ai"],"gitSource":{"type":"github","owner":"mpadronm","repo":"your-product-here","deployBranch":"main","contentDirectory":"mintlify","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a98ef75997600f0a052f7ec","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":28},{"language":"default","tag":"Digital Samples","count":14},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Integrations","count":4},{"language":"default","tag":"Actors","count":4},{"language":"default","tag":"Webhooks","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Insta Swaps","count":3},{"language":"default","tag":"Account","count":2},{"language":"default","tag":"System","count":1}]},"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/digital-samples/update-digital-sample","slug":"/api-reference/digital-samples/update-digital-sample","pageMetadata":{"title":"Update digital sample","description":"Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional.\n\n**Seed Video Replacement Policy:**\nIf `seedVideoUrl` is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns `409 Conflict`) to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database.\n\nOn an **ACTIVE** sample, replacing the seed may demote the sample to `DRAFT` and disable collab/public flags until the new seed is re-validated.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /digital-samples/{id}","href":"/api-reference/digital-samples/update-digital-sample","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Seed Video Replacement Policy:\"\n }), \"\\nIf \", _jsx(_components.code, {\n children: \"seedVideoUrl\"\n }), \" is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns \", _jsx(_components.code, {\n children: \"409 Conflict\"\n }), \") to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"On an \", _jsx(_components.strong, {\n children: \"ACTIVE\"\n }), \" sample, replacing the seed may demote the sample to \", _jsx(_components.code, {\n children: \"DRAFT\"\n }), \" and disable collab/public flags until the new seed is re-validated.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update digital sample","description":"Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional.\n\n**Seed Video Replacement Policy:**\nIf `seedVideoUrl` is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns `409 Conflict`) to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database.\n\nOn an **ACTIVE** sample, replacing the seed may demote the sample to `DRAFT` and disable collab/public flags until the new seed is re-validated.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /digital-samples/{id}","href":"/api-reference/digital-samples/update-digital-sample","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Digital Samples"],"summary":"Update digital sample","description":"Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional.\n\n**Seed Video Replacement Policy:**\nIf `seedVideoUrl` is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns `409 Conflict`) to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database.\n\nOn an **ACTIVE** sample, replacing the seed may demote the sample to `DRAFT` and disable collab/public flags until the new seed is re-validated.\n","parameters":["f8fbef24-b06b-4607-aa19-cd1fec42ae84"],"requestBody":"c96a9b72-0c0b-418f-a44b-0458112c34ac","responses":{"200":"0ed1161c-4705-4f81-abd0-2381311a8ae8","400":"fc6878d9-5030-4b53-bca7-129743371617","401":"4e1a1856-cade-4d52-914b-83921de688fb","404":"9d504ada-5118-464b-909b-e0dc00d8f19a","409":"1d3c3706-b365-413f-8af2-e65170809cd6"},"method":"patch","type":"path","servers":["be9e2f9e-e73e-4336-8325-240a930db14d"],"security":["4ed55f4b-e3cf-4b0e-a430-c8b0be001229"],"path":"/digital-samples/{id}","baseUrlOptions":["https://api.yourproducthere.ai/v1"],"title":"Update digital sample","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f8fbef24-b06b-4607-aa19-cd1fec42ae84":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":120,"description":"Optional updated title (Max 120 characters).","uniqueKey":"title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","maxLength":300,"description":"Optional description (Max 300 characters).","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":300,"description":"Optional description (Max 300 characters).","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"status":{"type":"string","enum":["DRAFT","ACTIVE","ARCHIVED"],"description":"Optional updated lifecycle status. Updating to ARCHIVED soft-deletes the sample and permanently blocks any new InstaSwap creations for it.","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"positiveRenderPrompt":{"oneOf":[{"type":"string","maxLength":2000,"description":"Optional custom positive render prompt (Max 2000 characters).","uniqueKey":"positiveRenderPrompt.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":2000,"description":"Optional custom positive render prompt (Max 2000 characters).","uniqueKey":"positiveRenderPrompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"positiveRenderPrompt","typeLabel":"string | null"},"negativeRenderPrompt":{"oneOf":[{"type":"string","maxLength":2000,"description":"Optional custom negative render prompt (Max 2000 characters).","uniqueKey":"negativeRenderPrompt.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":2000,"description":"Optional custom negative render prompt (Max 2000 characters).","uniqueKey":"negativeRenderPrompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"negativeRenderPrompt","typeLabel":"string | null"},"renderSeedFps":{"type":"integer","enum":[16,24,30],"description":"Optional updated seed FPS tier.","uniqueKey":"renderSeedFps","typeLabel":"enum\u003cinteger>"},"renderVoiceConversionEnabled":{"type":"boolean","description":"Optional updated CosyVoice replacement status.","uniqueKey":"renderVoiceConversionEnabled","typeLabel":"boolean"},"renderEntryWidth":{"type":"integer","enum":[480,720],"description":"Optional updatedPortrait 9:16 analysis size.","uniqueKey":"renderEntryWidth","typeLabel":"enum\u003cinteger>"},"seedVideoUrl":{"oneOf":[{"type":"string","format":"uri","description":"Optional public HTTPS URL of a new seed video. YPH securely ingests and validates the file. Echoed in responses; use `signedSeedVideoUrl` to preview. Pass null to clear the seed.","uniqueKey":"seedVideoUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Optional public HTTPS URL of a new seed video. YPH securely ingests and validates the file. Echoed in responses; use `signedSeedVideoUrl` to preview. Pass null to clear the seed.","uniqueKey":"seedVideoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"seedVideoUrl","typeLabel":"string\u003curi> | null"},"seedVideoDurationSec":{"oneOf":[{"type":"integer","maximum":170,"description":"Optional duration in seconds for the replaced seed (must be 170 seconds or less).","uniqueKey":"seedVideoDurationSec.oneOf.0","typeLabel":"integer"},{"type":"null","maximum":170,"description":"Optional duration in seconds for the replaced seed (must be 170 seconds or less).","uniqueKey":"seedVideoDurationSec.oneOf.1","typeLabel":"null"}],"uniqueKey":"seedVideoDurationSec","typeLabel":"integer | null"},"accountToken":{"oneOf":[{"type":"string","maxLength":128,"description":"Optional updated brand `accountToken` (pass null to clear).","uniqueKey":"accountToken.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":128,"description":"Optional updated brand `accountToken` (pass null to clear).","uniqueKey":"accountToken.oneOf.1","typeLabel":"null"}],"uniqueKey":"accountToken","typeLabel":"string | null"},"productToken":{"oneOf":[{"type":"string","maxLength":128,"description":"Optional updated catalog `productToken` (pass null to clear).","uniqueKey":"productToken.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":128,"description":"Optional updated catalog `productToken` (pass null to clear).","uniqueKey":"productToken.oneOf.1","typeLabel":"null"}],"uniqueKey":"productToken","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","description":"\u003cstring>","positiveRenderPrompt":"\u003cstring>","negativeRenderPrompt":"\u003cstring>","renderVoiceConversionEnabled":true,"seedVideoUrl":"\u003cstring>","seedVideoDurationSec":123,"accountToken":"\u003cstring>","productToken":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"0ed1161c-4705-4f81-abd0-2381311a8ae8":{"description":"Updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"digitalSample":{"type":"object","description":"Digital sample resource returned by GET, POST, and PATCH.\n- **Write-only (POST/PATCH body):** `seedVideoUrl` — your public HTTPS source URL. YPH ingests a copy into private storage. Use the presigned upload flow (`/seed/upload-url` + `/seed/register`) when uploading directly.\n- **Read-only (responses):** `signedSeedVideoUrl` — short-lived presigned GET URL for preview/download. Never send this back on PATCH.\n- **Echo (responses):** `seedVideoUrl` repeats the external source URL you submitted (null when the seed was uploaded via presigned PUT or created in the YPH app).\n- **Integrator identity:** `accountToken` identifies the **brand** (your marketplace advertiser). `productToken` is your internal catalog product id. See [Integrator tokens](/guides/integrator-tokens).\n- **Credits:** Org credit balance is not on this resource — use `GET /account` (`creditBalance`).\n","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"digitalSample.id","typeLabel":"string\u003cuuid>"},"orgId":{"oneOf":[{"type":"string","uniqueKey":"digitalSample.orgId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"digitalSample.orgId.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.orgId","typeLabel":"string | null"},"title":{"type":"string","uniqueKey":"digitalSample.title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"digitalSample.description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"digitalSample.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.description","typeLabel":"string | null"},"positiveRenderPrompt":{"oneOf":[{"type":"string","uniqueKey":"digitalSample.positiveRenderPrompt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"digitalSample.positiveRenderPrompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.positiveRenderPrompt","typeLabel":"string | null"},"negativeRenderPrompt":{"oneOf":[{"type":"string","uniqueKey":"digitalSample.negativeRenderPrompt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"digitalSample.negativeRenderPrompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.negativeRenderPrompt","typeLabel":"string | null"},"renderSeedFps":{"type":"integer","uniqueKey":"digitalSample.renderSeedFps","typeLabel":"integer"},"renderVoiceConversionEnabled":{"type":"boolean","uniqueKey":"digitalSample.renderVoiceConversionEnabled","typeLabel":"boolean"},"renderEntryWidth":{"type":"integer","uniqueKey":"digitalSample.renderEntryWidth","typeLabel":"integer"},"seedVideoUrl":{"oneOf":[{"type":"string","format":"uri","readOnly":true,"description":"Echo of your external seed video HTTPS URL (write via POST/PATCH body only). Null when the seed was uploaded via presigned PUT or the YPH app.","uniqueKey":"digitalSample.seedVideoUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","readOnly":true,"description":"Echo of your external seed video HTTPS URL (write via POST/PATCH body only). Null when the seed was uploaded via presigned PUT or the YPH app.","uniqueKey":"digitalSample.seedVideoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.seedVideoUrl","typeLabel":"string\u003curi> | null"},"signedSeedVideoUrl":{"oneOf":[{"type":"string","format":"uri","readOnly":true,"description":"Short-lived presigned GET URL for the ingested seed video (typically valid ~15 minutes).","uniqueKey":"digitalSample.signedSeedVideoUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","readOnly":true,"description":"Short-lived presigned GET URL for the ingested seed video (typically valid ~15 minutes).","uniqueKey":"digitalSample.signedSeedVideoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.signedSeedVideoUrl","typeLabel":"string\u003curi> | null"},"seedAssetPending":{"type":"boolean","uniqueKey":"digitalSample.seedAssetPending","typeLabel":"boolean"},"seedVideoDurationSec":{"oneOf":[{"type":"integer","uniqueKey":"digitalSample.seedVideoDurationSec.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"digitalSample.seedVideoDurationSec.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.seedVideoDurationSec","typeLabel":"integer | null"},"status":{"type":"string","enum":["DRAFT","ACTIVE","ARCHIVED"],"uniqueKey":"digitalSample.status","typeLabel":"enum\u003cstring>"},"videoReviewStatus":{"oneOf":[{"type":"string","enum":["IN_REVIEW","CHANGES_REQUESTED","APPROVED"],"uniqueKey":"digitalSample.videoReviewStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["IN_REVIEW","CHANGES_REQUESTED","APPROVED"],"uniqueKey":"digitalSample.videoReviewStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.videoReviewStatus","typeLabel":"enum\u003cstring> | null"},"accountToken":{"oneOf":[{"type":"string","maxLength":128,"description":"Integrator brand id (opaque, scoped to your org).","uniqueKey":"digitalSample.accountToken.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":128,"description":"Integrator brand id (opaque, scoped to your org).","uniqueKey":"digitalSample.accountToken.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.accountToken","typeLabel":"string | null"},"productToken":{"oneOf":[{"type":"string","maxLength":128,"description":"Integrator catalog product id (optional).","uniqueKey":"digitalSample.productToken.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":128,"description":"Integrator catalog product id (optional).","uniqueKey":"digitalSample.productToken.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.productToken","typeLabel":"string | null"},"renderMetadataStatus":{"oneOf":[{"type":"string","enum":["pending","running","ready","failed"],"readOnly":true,"description":"Variation-scoped render-metadata readiness for actor-swap renders, surfaced when the read resolves the active/selected variation. Internal mask/pose bundle keys are never exposed. Omitted when not applicable.","uniqueKey":"digitalSample.renderMetadataStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["pending","running","ready","failed"],"readOnly":true,"description":"Variation-scoped render-metadata readiness for actor-swap renders, surfaced when the read resolves the active/selected variation. Internal mask/pose bundle keys are never exposed. Omitted when not applicable.","uniqueKey":"digitalSample.renderMetadataStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"digitalSample.renderMetadataStatus","typeLabel":"enum\u003cstring> | null"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"digitalSample.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"digitalSample.updatedAt","typeLabel":"string\u003cdate-time>"}},"example":{"id":"d3b07384-d113-4956-a5e2-416b2a41bc3c","orgId":"org_123abc","title":"Summer Vacation","description":"Outdoor digital sample for summer looks","positiveRenderPrompt":"cinematic sunset, detailed face, 8k","negativeRenderPrompt":"blurry, low quality, bad hands","renderSeedFps":30,"renderVoiceConversionEnabled":true,"renderEntryWidth":720,"seedVideoUrl":"https://cdn.example.com/seeds/summer.mp4","signedSeedVideoUrl":"https://account.r2.cloudflarestorage.com/bucket/seed-assets/sample.mp4?X-Amz-Signature=...","seedAssetPending":false,"seedVideoDurationSec":15,"status":"ACTIVE","videoReviewStatus":"APPROVED","accountToken":"brand_nike","productToken":"sku_air_max_90","createdAt":"2026-06-20T12:00:00Z","updatedAt":"2026-06-20T12:05:00Z"},"uniqueKey":"digitalSample","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"digitalSample":{"id":"d3b07384-d113-4956-a5e2-416b2a41bc3c","orgId":"org_123abc","title":"Summer Vacation","description":"Outdoor digital sample for summer looks","positiveRenderPrompt":"cinematic sunset, detailed face, 8k","negativeRenderPrompt":"blurry, low quality, bad hands","renderSeedFps":30,"renderVoiceConversionEnabled":true,"renderEntryWidth":720,"seedVideoUrl":"https://cdn.example.com/seeds/summer.mp4","signedSeedVideoUrl":"https://account.r2.cloudflarestorage.com/bucket/seed-assets/sample.mp4?X-Amz-Signature=...","seedAssetPending":false,"seedVideoDurationSec":15,"status":"ACTIVE","videoReviewStatus":"APPROVED","accountToken":"brand_nike","productToken":"sku_air_max_90","createdAt":"2026-06-20T12:00:00Z","updatedAt":"2026-06-20T12:05:00Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"fc6878d9-5030-4b53-bca7-129743371617":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"A machine-readable, uppercase error code (e.g. `REQUIRED_FIELD_MISSING`, `INVALID_PARAMETER`, `RESOURCE_NOT_FOUND`, `UNAUTHORIZED`, `CONFLICT`).","uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","description":"A human-readable error message explaining why the request failed.","uniqueKey":"error","typeLabel":"string"},"parameter":{"oneOf":[{"type":"string","description":"The name of the specific input parameter or body field that caused the error (e.g. `seedVideoUrl`, `title`, etc.).","uniqueKey":"parameter.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the specific input parameter or body field that caused the error (e.g. `seedVideoUrl`, `title`, etc.).","uniqueKey":"parameter.oneOf.1","typeLabel":"null"}],"uniqueKey":"parameter","typeLabel":"string | null"},"details":{"oneOf":[{"type":"object","description":"Additional key-value pairs providing context or structured details about the failure.","uniqueKey":"details.oneOf.0","typeLabel":"object"},{"type":"null","description":"Additional key-value pairs providing context or structured details about the failure.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"object | null"}},"example":{"code":"REQUIRED_FIELD_MISSING","error":"title is required","parameter":"title","details":null},"uniqueKey":"","typeLabel":"object"},"examples":{"missingTitle":{"title":"missingTitle","summary":"Missing Required Title","value":{"code":"REQUIRED_FIELD_MISSING","error":"title is required","parameter":"title"}},"invalidFps":{"title":"invalidFps","summary":"Invalid FPS Value","value":{"code":"INVALID_PARAMETER","error":"renderSeedFps must be 16, 24, or 30","parameter":"renderSeedFps"}},"invalidWidth":{"title":"invalidWidth","summary":"Invalid Entry Width","value":{"code":"INVALID_PARAMETER","error":"renderEntryWidth must be 480 or 720","parameter":"renderEntryWidth"}},"durationExceeded":{"title":"durationExceeded","summary":"Seed Video Too Long","value":{"code":"INVALID_PARAMETER","error":"video duration exceeds maximum allowed 170 seconds","parameter":"seedVideoUrl"}}},"exampleType":"examples"}},"exampleType":"examples"},"4e1a1856-cade-4d52-914b-83921de688fb":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"A machine-readable, uppercase error code (e.g. `REQUIRED_FIELD_MISSING`, `INVALID_PARAMETER`, `RESOURCE_NOT_FOUND`, `UNAUTHORIZED`, `CONFLICT`).","uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","description":"A human-readable error message explaining why the request failed.","uniqueKey":"error","typeLabel":"string"},"parameter":{"oneOf":[{"type":"string","description":"The name of the specific input parameter or body field that caused the error (e.g. `seedVideoUrl`, `title`, etc.).","uniqueKey":"parameter.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the specific input parameter or body field that caused the error (e.g. `seedVideoUrl`, `title`, etc.).","uniqueKey":"parameter.oneOf.1","typeLabel":"null"}],"uniqueKey":"parameter","typeLabel":"string | null"},"details":{"oneOf":[{"type":"object","description":"Additional key-value pairs providing context or structured details about the failure.","uniqueKey":"details.oneOf.0","typeLabel":"object"},{"type":"null","description":"Additional key-value pairs providing context or structured details about the failure.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"object | null"}},"example":{"code":"REQUIRED_FIELD_MISSING","error":"title is required","parameter":"title","details":null},"uniqueKey":"","typeLabel":"object"},"examples":{"unauthorized":{"title":"unauthorized","summary":"Invalid API Key","value":{"code":"UNAUTHORIZED","error":"Unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"},"9d504ada-5118-464b-909b-e0dc00d8f19a":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"A machine-readable, uppercase error code (e.g. `REQUIRED_FIELD_MISSING`, `INVALID_PARAMETER`, `RESOURCE_NOT_FOUND`, `UNAUTHORIZED`, `CONFLICT`).","uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","description":"A human-readable error message explaining why the request failed.","uniqueKey":"error","typeLabel":"string"},"parameter":{"oneOf":[{"type":"string","description":"The name of the specific input parameter or body field that caused the error (e.g. `seedVideoUrl`, `title`, etc.).","uniqueKey":"parameter.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the specific input parameter or body field that caused the error (e.g. `seedVideoUrl`, `title`, etc.).","uniqueKey":"parameter.oneOf.1","typeLabel":"null"}],"uniqueKey":"parameter","typeLabel":"string | null"},"details":{"oneOf":[{"type":"object","description":"Additional key-value pairs providing context or structured details about the failure.","uniqueKey":"details.oneOf.0","typeLabel":"object"},{"type":"null","description":"Additional key-value pairs providing context or structured details about the failure.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"object | null"}},"example":{"code":"REQUIRED_FIELD_MISSING","error":"title is required","parameter":"title","details":null},"uniqueKey":"","typeLabel":"object"},"examples":{"sampleNotFound":{"title":"sampleNotFound","summary":"Digital Sample Not Found","value":{"code":"RESOURCE_NOT_FOUND","error":"digital sample not found"}},"actorNotFound":{"title":"actorNotFound","summary":"Actor Not Found","value":{"code":"RESOURCE_NOT_FOUND","error":"Actor not found or forbidden"}}},"exampleType":"examples"}},"exampleType":"examples"},"1d3c3706-b365-413f-8af2-e65170809cd6":{"description":"Conflict due to operational constraints or state","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"A machine-readable, uppercase error code (e.g. `REQUIRED_FIELD_MISSING`, `INVALID_PARAMETER`, `RESOURCE_NOT_FOUND`, `UNAUTHORIZED`, `CONFLICT`).","uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","description":"A human-readable error message explaining why the request failed.","uniqueKey":"error","typeLabel":"string"},"parameter":{"oneOf":[{"type":"string","description":"The name of the specific input parameter or body field that caused the error (e.g. `seedVideoUrl`, `title`, etc.).","uniqueKey":"parameter.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the specific input parameter or body field that caused the error (e.g. `seedVideoUrl`, `title`, etc.).","uniqueKey":"parameter.oneOf.1","typeLabel":"null"}],"uniqueKey":"parameter","typeLabel":"string | null"},"details":{"oneOf":[{"type":"object","description":"Additional key-value pairs providing context or structured details about the failure.","uniqueKey":"details.oneOf.0","typeLabel":"object"},{"type":"null","description":"Additional key-value pairs providing context or structured details about the failure.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"object | null"}},"example":{"code":"REQUIRED_FIELD_MISSING","error":"title is required","parameter":"title","details":null},"uniqueKey":"","typeLabel":"object"},"examples":{"collabsActive":{"title":"collabsActive","summary":"Active Collaborations","value":{"code":"CONFLICT","error":"Replacing the seed video is blocked because this digital sample has active collaborations.","parameter":"seedVideoUrl"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"4ed55f4b-e3cf-4b0e-a430-c8b0be001229":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your organization API key starting with yph_sk_live_…","scopes":[]}}},"servers":{"be9e2f9e-e73e-4336-8325-240a930db14d":{"url":"https://api.yourproducthere.ai/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your organization API key starting with yph_sk_live_…","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your organization API key starting with yph_sk_live_…","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"yphai","siteName":"Your Product Here API","title":"Update digital sample - Your Product Here API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-24T08:54:00.929Z","originalFileLocation":"api-reference/digital-samples/update-digital-sample.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=\"Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional. Seed Video Replacement Policy: If seedVideoUrl is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns 409 Conflict) to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database. On an ACTIVE sample, replacing the seed may demote the sample to DRAFT and disable collab/public flags until the new seed is re-validated.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Your Product Here API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/yphai/4VAq6KvfY7w0UTvs/_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/yphai/4VAq6KvfY7w0UTvs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/yphai/4VAq6KvfY7w0UTvs/_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/yphai/4VAq6KvfY7w0UTvs/_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/yphai/4VAq6KvfY7w0UTvs/_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/yphai/4VAq6KvfY7w0UTvs/_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/yphai/4VAq6KvfY7w0UTvs/_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/yphai/4VAq6KvfY7w0UTvs/_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/yphai/4VAq6KvfY7w0UTvs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update digital sample - Your Product Here API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional. Seed Video Replacement Policy: If seedVideoUrl is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns 409 Conflict) to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database. On an ACTIVE sample, replacing the seed may demote the sample to DRAFT and disable collab/public flags until the new seed is re-validated.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Your Product Here API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://yphai.mintlify.site/_mintlify/api/og/v2?division=Digital+Samples\u0026amp;title=Update+digital+sample\u0026amp;description=Update+configuration%2C+prompts%2C+advanced+render+parameters%2C+or+title%2Fdescription+of+an+existing+digital+sample.+All+fields+in+the+body+are+optional.%0A%0A**Seed+Vide\u0026amp;theme=bc7af9f267c915940f89ed4a\u0026amp;signature=fbc0cbe5e51ffa12d19465b1daee06b3ca5525b4db08ae05de48f1ad4ddbd967\">\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=\"Update digital sample - Your Product Here API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional. Seed Video Replacement Policy: If seedVideoUrl is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns 409 Conflict) to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database. On an ACTIVE sample, replacing the seed may demote the sample to DRAFT and disable collab/public flags until the new seed is re-validated.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://yphai.mintlify.site/_mintlify/api/og/v2?division=Digital+Samples\u0026amp;title=Update+digital+sample\u0026amp;description=Update+configuration%2C+prompts%2C+advanced+render+parameters%2C+or+title%2Fdescription+of+an+existing+digital+sample.+All+fields+in+the+body+are+optional.%0A%0A**Seed+Vide\u0026amp;theme=bc7af9f267c915940f89ed4a\u0026amp;signature=fbc0cbe5e51ffa12d19465b1daee06b3ca5525b4db08ae05de48f1ad4ddbd967\">\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/yphai/4VAq6KvfY7w0UTvs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Your Product Here API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8b5cf6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/digital-samples/update-digital-sample.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.yourproducthere.ai/#organization\",\"name\":\"Your Product Here API\",\"url\":\"https://docs.yourproducthere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/yphai/4tKX1GeDxYXfYG9B/logo.webp?fit=max\u0026auto=format\u0026n=4tKX1GeDxYXfYG9B\u0026q=85\u0026s=b4d155d7687a9237366e89f3d8a8e04f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.yourproducthere.ai#website\",\"name\":\"Your Product Here API\",\"url\":\"https://docs.yourproducthere.ai\",\"publisher\":{\"@id\":\"https://docs.yourproducthere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample#webpage\",\"url\":\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample\",\"name\":\"Update digital sample\",\"description\":\"Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional. Seed Video Replacement Policy: If seedVideoUrl is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns 409 Conflict) to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database. On an ACTIVE sample, replacing the seed may demote the sample to DRAFT and disable collab/public flags until the new seed is re-validated.\",\"dateModified\":\"2026-07-24T08:54:00.929Z\",\"isPartOf\":{\"@id\":\"https://docs.yourproducthere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Digital Samples\",\"item\":\"https://docs.yourproducthere.ai/api-reference/digital-samples/list-digital-samples\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update digital sample\",\"item\":\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample#apireference\",\"headline\":\"Update digital sample\",\"name\":\"Update digital sample\",\"description\":\"Update configuration, prompts, advanced render parameters, or title/description of an existing digital sample. All fields in the body are optional. Seed Video Replacement Policy: If seedVideoUrl is provided, it replaces the current seed video. Note that replacing the seed video of a digital sample with active collaborations is blocked (returns 409 Conflict) to safeguard operational consistency. If a seed video is successfully replaced, any existing unlinked or old seed video is safely replaced in the database. On an ACTIVE sample, replacing the seed may demote the sample to DRAFT and disable collab/public flags until the new seed is re-validated.\",\"url\":\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample\",\"mainEntityOfPage\":{\"@id\":\"https://docs.yourproducthere.ai/api-reference/digital-samples/update-digital-sample#webpage\"},\"dateModified\":\"2026-07-24T08:54:00.929Z\",\"publisher\":{\"@id\":\"https://docs.yourproducthere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.yourproducthere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Your Product Here API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Your Product Here API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/digital-samples/update-digital-sample.md","siteName":"Your Product Here API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"System","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"/openapi.yaml get /health","href":"/api-reference/system/health-check"}]},{"group":"Account","pages":[{"title":"Organization account","deprecated":null,"version":null,"openapi":"/openapi.yaml get /account","href":"/api-reference/account/organization-account"},{"title":"Account usage analytics","deprecated":null,"version":null,"openapi":"/openapi.yaml get /account/analytics","href":"/api-reference/account/account-usage-analytics"}]},{"group":"Actors","pages":[{"title":"List actors","deprecated":null,"version":null,"openapi":"/openapi.yaml get /actors","href":"/api-reference/actors/list-actors"},{"title":"Create actor","deprecated":null,"version":null,"openapi":"/openapi.yaml post /actors","href":"/api-reference/actors/create-actor"},{"title":"Delete actor","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /actors/{id}","href":"/api-reference/actors/delete-actor"},{"title":"Update actor","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /actors/{id}","href":"/api-reference/actors/update-actor"}]},{"group":"Digital Samples","pages":[{"title":"List digital samples","deprecated":null,"version":null,"openapi":"/openapi.yaml get /digital-samples","href":"/api-reference/digital-samples/list-digital-samples"},{"title":"Create digital sample","deprecated":null,"version":null,"openapi":"/openapi.yaml post /digital-samples","href":"/api-reference/digital-samples/create-digital-sample"},{"title":"Get digital sample","deprecated":null,"version":null,"openapi":"/openapi.yaml get /digital-samples/{id}","href":"/api-reference/digital-samples/get-digital-sample"},{"title":"Delete digital sample","description":"Permanently delete a digital sample and cascade-remove its insta-swap render jobs.\nDeletes associated R2 seed video objects (`seed-assets/…`) and render results (`results/{jobId}/result.mp4`).\nBlocked with `409 Conflict` when collaborators exist on the sample.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /digital-samples/{id}","href":"/api-reference/digital-samples/delete-digital-sample"},{"title":"Update digital sample","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /digital-samples/{id}","href":"/api-reference/digital-samples/update-digital-sample"},{"title":"Mint presigned seed upload URL","description":"Get a secure presigned R2 PUT URL to upload your seed video directly.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /digital-samples/{id}/seed/upload-url","href":"/api-reference/digital-samples/mint-presigned-seed-upload-url"},{"title":"Register uploaded seed key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /digital-samples/{id}/seed/register","href":"/api-reference/digital-samples/register-uploaded-seed-key"},{"title":"Get seed video analysis","deprecated":null,"version":null,"openapi":"/openapi.yaml get /digital-samples/{id}/analysis","href":"/api-reference/digital-samples/get-seed-video-analysis"},{"title":"List variation proposals","deprecated":null,"version":null,"openapi":"/openapi.yaml get /digital-samples/{id}/variations","href":"/api-reference/digital-samples/list-variation-proposals"},{"title":"Propose more variations","deprecated":null,"version":null,"openapi":"/openapi.yaml post /digital-samples/{id}/variations/propose","href":"/api-reference/digital-samples/propose-more-variations"},{"title":"Enable or disable a variation for Collab / Insta Swap","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /digital-samples/{id}/variations/{variationId}","href":"/api-reference/digital-samples/enable-or-disable-a-variation-for-collab-insta-swap"},{"title":"Assemble variation MP4","deprecated":null,"version":null,"openapi":"/openapi.yaml post /digital-samples/{id}/variations/{variationId}/assemble","href":"/api-reference/digital-samples/assemble-variation-mp4"},{"title":"List selectable seeds for render","deprecated":null,"version":null,"openapi":"/openapi.yaml get /digital-samples/{id}/available-seeds","href":"/api-reference/digital-samples/list-selectable-seeds-for-render"},{"title":"Toggle original seed for creators","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /digital-samples/{id}/seed-options","href":"/api-reference/digital-samples/toggle-original-seed-for-creators"}]},{"group":"Insta Swaps","pages":[{"title":"List insta swaps for a sample","deprecated":null,"version":null,"openapi":"/openapi.yaml get /digital-samples/{id}/insta-swaps","href":"/api-reference/insta-swaps/list-insta-swaps-for-a-sample"},{"title":"Create and queue insta swap","deprecated":null,"version":null,"openapi":"/openapi.yaml post /digital-samples/{id}/insta-swaps","href":"/api-reference/insta-swaps/create-and-queue-insta-swap"},{"title":"Get insta swap status","deprecated":null,"version":null,"openapi":"/openapi.yaml get /insta-swaps/{id}","href":"/api-reference/insta-swaps/get-insta-swap-status"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.yaml get /webhooks","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.yaml post /webhooks","href":"/api-reference/webhooks/create-webhook-endpoint"},{"title":"Delete webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /webhooks/{id}","href":"/api-reference/webhooks/delete-webhook-endpoint"},{"title":"List recent deliveries","deprecated":null,"version":null,"openapi":"/openapi.yaml get /webhooks/{id}/deliveries","href":"/api-reference/webhooks/list-recent-deliveries"}]}]}]},"basePath":"","title":"Update digital sample - Your Product Here API","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}