{
"code": "RESOURCE_NOT_FOUND",
"error": "insta swap not found"
}
Insta Swaps
Get insta swap status
Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived signedResultVideoUrl that is valid for 1 hour.
{
"code": "RESOURCE_NOT_FOUND",
"error": "insta swap not found"
}
Authorizations
Authorization
string
header
required
Your organization API key starting with yph_sk_live_…
Path Parameters
id
string<uuid>
required
Response
Swap status details retrieved successfully
instaSwap
object
Insta swap render job. accountToken on the swap is the integrator id for whoever initiated it (creator or brand).
sampleAccountToken and productToken are read from the parent digital sample.
When isBrandSelfService is true, accountToken equals sampleAccountToken (brand-owned production, not a creator application).
{"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":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/insta-swaps/get-insta-swap-status","slug":"/api-reference/insta-swaps/get-insta-swap-status","pageMetadata":{"title":"Get insta swap status","description":"Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived `signedResultVideoUrl` that is valid for 1 hour.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /insta-swaps/{id}","href":"/api-reference/insta-swaps/get-insta-swap-status","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived \", _jsx(_components.code, {\n children: \"signedResultVideoUrl\"\n }), \" that is valid for 1 hour.\"]\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":"Get insta swap status","description":"Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived `signedResultVideoUrl` that is valid for 1 hour.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /insta-swaps/{id}","href":"/api-reference/insta-swaps/get-insta-swap-status","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Insta Swaps"],"summary":"Get insta swap status","description":"Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived `signedResultVideoUrl` that is valid for 1 hour.","parameters":["973166a5-fb8d-45fb-aa55-a7fd3f4ac981"],"responses":{"200":"845522dd-bdd4-4846-863c-93cd98d54b22","401":"9c1d3e65-f438-49bc-b4d5-4072ad7725cb","404":"b5ee262a-bab0-4dc5-a4ca-84f22360bea9"},"method":"get","type":"path","servers":["be9e2f9e-e73e-4336-8325-240a930db14d"],"security":["4ed55f4b-e3cf-4b0e-a430-c8b0be001229"],"path":"/insta-swaps/{id}","baseUrlOptions":["https://api.yourproducthere.ai/v1"],"title":"Get insta swap status","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"973166a5-fb8d-45fb-aa55-a7fd3f4ac981":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"845522dd-bdd4-4846-863c-93cd98d54b22":{"description":"Swap status details retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"instaSwap":{"type":"object","description":"Insta swap render job. `accountToken` on the swap is the integrator id for whoever initiated it (creator or brand).\n`sampleAccountToken` and `productToken` are read from the parent digital sample.\nWhen `isBrandSelfService` is true, `accountToken` equals `sampleAccountToken` (brand-owned production, not a creator application).\n","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"instaSwap.id","typeLabel":"string\u003cuuid>"},"orgId":{"type":"string","uniqueKey":"instaSwap.orgId","typeLabel":"string"},"digitalSampleId":{"type":"string","format":"uuid","uniqueKey":"instaSwap.digitalSampleId","typeLabel":"string\u003cuuid>"},"digitalSampleVariationId":{"oneOf":[{"type":"string","format":"uuid","description":"Variation seed used for this render; null when original seed was used.","uniqueKey":"instaSwap.digitalSampleVariationId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Variation seed used for this render; null when original seed was used.","uniqueKey":"instaSwap.digitalSampleVariationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"instaSwap.digitalSampleVariationId","typeLabel":"string\u003cuuid> | null"},"actorId":{"type":"string","format":"uuid","uniqueKey":"instaSwap.actorId","typeLabel":"string\u003cuuid>"},"accountToken":{"oneOf":[{"type":"string","maxLength":128,"uniqueKey":"instaSwap.accountToken.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":128,"uniqueKey":"instaSwap.accountToken.oneOf.1","typeLabel":"null"}],"uniqueKey":"instaSwap.accountToken","typeLabel":"string | null"},"sampleAccountToken":{"oneOf":[{"type":"string","maxLength":128,"readOnly":true,"description":"Brand token from the parent digital sample.","uniqueKey":"instaSwap.sampleAccountToken.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":128,"readOnly":true,"description":"Brand token from the parent digital sample.","uniqueKey":"instaSwap.sampleAccountToken.oneOf.1","typeLabel":"null"}],"uniqueKey":"instaSwap.sampleAccountToken","typeLabel":"string | null"},"productToken":{"oneOf":[{"type":"string","maxLength":128,"readOnly":true,"description":"Catalog product token from the parent digital sample.","uniqueKey":"instaSwap.productToken.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":128,"readOnly":true,"description":"Catalog product token from the parent digital sample.","uniqueKey":"instaSwap.productToken.oneOf.1","typeLabel":"null"}],"uniqueKey":"instaSwap.productToken","typeLabel":"string | null"},"isBrandSelfService":{"type":"boolean","readOnly":true,"description":"True when swap `accountToken` equals the parent sample's `accountToken`.","uniqueKey":"instaSwap.isBrandSelfService","typeLabel":"boolean"},"status":{"type":"string","enum":["QUEUED","ASSIGNED","RENDERING","PENDING_APPROVAL","COMPLETED","FAILED","EXPIRED","CANCELLED"],"description":"Render pipeline status. Treat unknown values as in-progress.","uniqueKey":"instaSwap.status","typeLabel":"enum\u003cstring>"},"triggerSource":{"type":"string","enum":["app","api"],"uniqueKey":"instaSwap.triggerSource","typeLabel":"enum\u003cstring>"},"renderingMs":{"oneOf":[{"type":"integer","uniqueKey":"instaSwap.renderingMs.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"instaSwap.renderingMs.oneOf.1","typeLabel":"null"}],"uniqueKey":"instaSwap.renderingMs","typeLabel":"integer | null"},"startedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"instaSwap.startedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"instaSwap.startedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"instaSwap.startedAt","typeLabel":"string\u003cdate-time> | null"},"finishedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"instaSwap.finishedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"instaSwap.finishedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"instaSwap.finishedAt","typeLabel":"string\u003cdate-time> | null"},"signedResultVideoUrl":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"instaSwap.signedResultVideoUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"instaSwap.signedResultVideoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"instaSwap.signedResultVideoUrl","typeLabel":"string\u003curi> | null"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"instaSwap.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"instaSwap.updatedAt","typeLabel":"string\u003cdate-time>"}},"example":{"id":"e4e18374-f119-4b11-a8a1-d6a2bc38e41a","orgId":"org_123abc","digitalSampleId":"d3b07384-d113-4956-a5e2-416b2a41bc3c","actorId":"a1c02874-e339-4d11-8fa1-e6a2bc38c41d","accountToken":"creator_42","sampleAccountToken":"brand_nike","productToken":"sku_air_max_90","isBrandSelfService":false,"status":"COMPLETED","triggerSource":"api","renderingMs":4500,"startedAt":"2026-06-20T12:10:00Z","finishedAt":"2026-06-20T12:10:04.500Z","signedResultVideoUrl":"https://r2.yourproducthere.ai/results/completed_video.mp4?token=sig","createdAt":"2026-06-20T12:09:59Z","updatedAt":"2026-06-20T12:10:05Z"},"uniqueKey":"instaSwap","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"instaSwap":{"id":"e4e18374-f119-4b11-a8a1-d6a2bc38e41a","orgId":"org_123abc","digitalSampleId":"d3b07384-d113-4956-a5e2-416b2a41bc3c","actorId":"a1c02874-e339-4d11-8fa1-e6a2bc38c41d","accountToken":"creator_42","sampleAccountToken":"brand_nike","productToken":"sku_air_max_90","isBrandSelfService":false,"status":"COMPLETED","triggerSource":"api","renderingMs":4500,"startedAt":"2026-06-20T12:10:00Z","finishedAt":"2026-06-20T12:10:04.500Z","signedResultVideoUrl":"https://r2.yourproducthere.ai/results/completed_video.mp4?token=sig","createdAt":"2026-06-20T12:09:59Z","updatedAt":"2026-06-20T12:10:05Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9c1d3e65-f438-49bc-b4d5-4072ad7725cb":{"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"},"b5ee262a-bab0-4dc5-a4ca-84f22360bea9":{"description":"Insta swap task 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":{"swapNotFound":{"title":"swapNotFound","summary":"Insta Swap Not Found","value":{"code":"RESOURCE_NOT_FOUND","error":"insta swap not found"}}},"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":"Get insta swap status - Your Product Here API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-24T08:54:01.069Z","originalFileLocation":"api-reference/insta-swaps/get-insta-swap-status.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=\"Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived signedResultVideoUrl that is valid for 1 hour.\">\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=\"Get insta swap status - Your Product Here API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived signedResultVideoUrl that is valid for 1 hour.\">\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/insta-swaps/get-insta-swap-status\">\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=Insta+Swaps\u0026amp;title=Get+insta+swap+status\u0026amp;description=Retrieve+the+real-time+status+and+telemetry+of+an+individual+insta+swap+task.+Once+the+status+transitions+to+COMPLETED%2C+includes+a+temporary+short-lived+%60signed\u0026amp;theme=bc7af9f267c915940f89ed4a\u0026amp;signature=0f12f5441d366e2333706f9db56ce9f70773fcc2a2697cca69db4829e62190b0\">\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 insta swap status - Your Product Here API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived signedResultVideoUrl that is valid for 1 hour.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://yphai.mintlify.site/_mintlify/api/og/v2?division=Insta+Swaps\u0026amp;title=Get+insta+swap+status\u0026amp;description=Retrieve+the+real-time+status+and+telemetry+of+an+individual+insta+swap+task.+Once+the+status+transitions+to+COMPLETED%2C+includes+a+temporary+short-lived+%60signed\u0026amp;theme=bc7af9f267c915940f89ed4a\u0026amp;signature=0f12f5441d366e2333706f9db56ce9f70773fcc2a2697cca69db4829e62190b0\">\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/insta-swaps/get-insta-swap-status\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/insta-swaps/get-insta-swap-status.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/insta-swaps/get-insta-swap-status#webpage\",\"url\":\"https://docs.yourproducthere.ai/api-reference/insta-swaps/get-insta-swap-status\",\"name\":\"Get insta swap status\",\"description\":\"Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived signedResultVideoUrl that is valid for 1 hour.\",\"dateModified\":\"2026-07-24T08:54:01.069Z\",\"isPartOf\":{\"@id\":\"https://docs.yourproducthere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.yourproducthere.ai/api-reference/insta-swaps/get-insta-swap-status#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.yourproducthere.ai/api-reference/insta-swaps/get-insta-swap-status#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Insta Swaps\",\"item\":\"https://docs.yourproducthere.ai/api-reference/insta-swaps/list-insta-swaps-for-a-sample\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get insta swap status\",\"item\":\"https://docs.yourproducthere.ai/api-reference/insta-swaps/get-insta-swap-status\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.yourproducthere.ai/api-reference/insta-swaps/get-insta-swap-status#apireference\",\"headline\":\"Get insta swap status\",\"name\":\"Get insta swap status\",\"description\":\"Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived signedResultVideoUrl that is valid for 1 hour.\",\"url\":\"https://docs.yourproducthere.ai/api-reference/insta-swaps/get-insta-swap-status\",\"mainEntityOfPage\":{\"@id\":\"https://docs.yourproducthere.ai/api-reference/insta-swaps/get-insta-swap-status#webpage\"},\"dateModified\":\"2026-07-24T08:54:01.069Z\",\"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/insta-swaps/get-insta-swap-status.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","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","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","description":"Auto-queues a render task to replace the sample seed's identity with the specified custom actor. Automatically processes and charges 1 credit. Pass `digitalSampleVariationId` to render an assembled variation cut; use `null` for the original seed when eligible (≤30s and enabled).","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","description":"Retrieve all configured webhook endpoints and available subscription event types for your organization.","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":"Get insta swap status - 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"]}