Attach a live API source to the migration, or update it in place. credentials (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Vern Documentation","colors":{"primary":"#10B981","light":"#10B981","dark":"#10B981"},"logo":{"light":"https://mintcdn.com/vern/xEWEVl-f4WbHT-6k/logo/light.svg?fit=max\u0026auto=format\u0026n=xEWEVl-f4WbHT-6k\u0026q=85\u0026s=0935c9d27922ebd917cfce0dcb725e8c","dark":"https://mintcdn.com/vern/xEWEVl-f4WbHT-6k/logo/dark.svg?fit=max\u0026auto=format\u0026n=xEWEVl-f4WbHT-6k\u0026q=85\u0026s=be7b12a31aaf3cfacd7691cbf8f468bc"},"favicon":"https://mintcdn.com/vern/VGwZnfx-38Sub0SU/favicon.ico?fit=max\u0026auto=format\u0026n=VGwZnfx-38Sub0SU\u0026q=85\u0026s=74ccbcba180f9f513dea96c094e6ffc4","navbar":{"links":[{"href":"mailto:roupen@vern.so","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.vern.so/companies"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/vern-so"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vern","hasAudioNarration":false,"actualSubdomain":"vern","customDomains":["docs.vern.so"],"gitSource":{"type":"github","owner":"vern-so","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aefaa9d59edac7bace72ec7","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Developer","count":24},{"language":"default","tag":"Guides","count":22},{"language":"default","tag":"API reference","count":18},{"language":"default","tag":"Runs","count":15},{"language":"default","tag":"Migrations","count":11},{"language":"default","tag":"Catalog","count":8},{"language":"default","tag":"Sources \u0026 templates","count":6},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"Export","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/migrations/create-or-update-the-source-connection","slug":"/api-reference/migrations/create-or-update-the-source-connection","pageMetadata":{"title":"Create or update the source connection","description":"Attach a live API source to the migration, or update it in place. `credentials` (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /migrations/{migration_id}/source-connection","href":"/api-reference/migrations/create-or-update-the-source-connection","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: [\"Attach a live API source to the migration, or update it in place. \", _jsx(_components.code, {\n children: \"credentials\"\n }), \" (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.\"]\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":"Create or update the source connection","description":"Attach a live API source to the migration, or update it in place. `credentials` (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /migrations/{migration_id}/source-connection","href":"/api-reference/migrations/create-or-update-the-source-connection","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"saveSourceConnection","summary":"Create or update the source connection","description":"Attach a live API source to the migration, or update it in place. `credentials` (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.","tags":["Migrations"],"requestBody":"5f4d4d78-eb9b-4409-9e32-e9ef3a40d2c6","responses":{"201":"2876b995-da83-4280-b7ed-14d979ef8eb5","400":"a1128e27-9a85-43ae-8873-533c49518f9c","401":"9c6d389b-572c-4717-908f-514650d61ac2","404":"236c6749-17ed-401c-bca5-c3990d1a2305","429":"1a10a5ae-2be7-4090-9b01-b51c61f57ba4"},"method":"post","type":"path","servers":["d5dd3c6d-4305-4406-a83e-e498a745a1bc","25cf5952-e71f-4bbc-9ba4-bcf677ba9742"],"security":["82c4823c-4f3d-4a37-9197-490742790554"],"path":"/migrations/{migration_id}/source-connection","baseUrlOptions":["https://app.vern.so/api/v1","https://au.app.vern.so/api/v1"],"title":"Create or update the source connection","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f4cee53d-07b8-4eae-8968-cf125391dd42":{"name":"migration_id","in":"path","required":true,"description":"The migration ID returned by Create a migration.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The migration ID returned by Create a migration.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"example":"c0a8012e-4f1b-4d3a-9b2c-7e6f5a4b3c2d"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["source_key"],"properties":{"source_key":{"type":"string","description":"The connector to attach, lower-cased. Unknown or not-yet-enabled keys return 400.","isRequired":true,"uniqueKey":"source_key","typeLabel":"string"},"profile_id":{"oneOf":[{"type":"string","description":"Scope to a profile; null binds to the workbook; omit for the default profile.","uniqueKey":"profile_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Scope to a profile; null binds to the workbook; omit for the default profile.","uniqueKey":"profile_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile_id","typeLabel":"string | null"},"config":{"type":"object","description":"Non-secret connector configuration.","additionalProperties":true,"uniqueKey":"config","typeLabel":"object"},"selected_streams":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"selected_streams.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Streams to extract, or null for connector default.","uniqueKey":"selected_streams.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Streams to extract, or null for connector default.","uniqueKey":"selected_streams.oneOf.1","typeLabel":"null"}],"uniqueKey":"selected_streams","typeLabel":"string[] | null"},"stream_state":{"type":"object","description":"Incremental-sync cursor state.","additionalProperties":true,"uniqueKey":"stream_state","typeLabel":"object"},"credentials":{"type":"object","description":"Secret values, vaulted and never returned.","additionalProperties":true,"uniqueKey":"credentials","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"source_key":"salesforce","config":{"instance_url":"https://acme.my.salesforce.com"},"selected_streams":["contacts","accounts"],"credentials":{"client_id":"…","client_secret":"…"}},"examples":{"Example":{"title":"Example","value":{"source_key":"salesforce","config":{"instance_url":"https://acme.my.salesforce.com"},"selected_streams":["contacts","accounts"],"credentials":{"client_id":"…","client_secret":"…"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"2876b995-da83-4280-b7ed-14d979ef8eb5":{"description":"The created or updated connection.","content":{"application/json":{"schema":{"type":"object","properties":{"source_connection":{"type":"object","description":"A migration's live API source connection. Never includes secret values; `creds_configured` reports whether credentials are stored.","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"source_connection.id","typeLabel":"string\u003cuuid>"},"profile_id":{"oneOf":[{"type":"string","uniqueKey":"source_connection.profile_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source_connection.profile_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_connection.profile_id","typeLabel":"string | null"},"source_key":{"type":"string","uniqueKey":"source_connection.source_key","typeLabel":"string"},"name":{"type":"string","description":"Connector display name; falls back to source_key.","uniqueKey":"source_connection.name","typeLabel":"string"},"category":{"oneOf":[{"type":"string","uniqueKey":"source_connection.category.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source_connection.category.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_connection.category","typeLabel":"string | null"},"config":{"type":"object","description":"Non-secret connector configuration.","additionalProperties":true,"uniqueKey":"source_connection.config","typeLabel":"object"},"selected_streams":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"source_connection.selected_streams.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"source_connection.selected_streams.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"source_connection.selected_streams.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_connection.selected_streams","typeLabel":"string[] | null"},"stream_state":{"type":"object","additionalProperties":true,"uniqueKey":"source_connection.stream_state","typeLabel":"object"},"creds_configured":{"type":"boolean","uniqueKey":"source_connection.creds_configured","typeLabel":"boolean"},"bound_source_extractor_id":{"oneOf":[{"type":"string","uniqueKey":"source_connection.bound_source_extractor_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source_connection.bound_source_extractor_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_connection.bound_source_extractor_id","typeLabel":"string | null"},"last_snapshot":{"oneOf":[{"type":"object","description":"Metadata about the most recent extraction.","uniqueKey":"source_connection.last_snapshot.oneOf.0","typeLabel":"object"},{"type":"null","description":"Metadata about the most recent extraction.","uniqueKey":"source_connection.last_snapshot.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_connection.last_snapshot","typeLabel":"object | null"},"last_sync_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"source_connection.last_sync_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"source_connection.last_sync_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_connection.last_sync_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"source_connection","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"source_connection":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","profile_id":"\u003cstring>","source_key":"\u003cstring>","name":"\u003cstring>","category":"\u003cstring>","config":{},"selected_streams":["\u003cstring>"],"stream_state":{},"creds_configured":true,"bound_source_extractor_id":"\u003cstring>","last_snapshot":{},"last_sync_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a1128e27-9a85-43ae-8873-533c49518f9c":{"description":"Malformed request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9c6d389b-572c-4717-908f-514650d61ac2":{"description":"API key missing, malformed, or revoked.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"236c6749-17ed-401c-bca5-c3990d1a2305":{"description":"The referenced resource isn't in your account.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1a10a5ae-2be7-4090-9b01-b51c61f57ba4":{"description":"Rate limit hit. Counted per account, not per API key. Creating a migration and starting a `generate` run are limited to 30/hour each; answering a run is limited to 30/hour; reads allow 30/minute and writes 30/minute. `Retry-After` gives the seconds until the window resets, alongside `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`.","headers":{"Retry-After":{"description":"Seconds until the rate-limit window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":"Too many requests"},"examples":{"Example":{"title":"Example","value":{"error":"Too many requests"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"82c4823c-4f3d-4a37-9197-490742790554":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your Vern API key. Create one at Settings → API keys.","scopes":[],"schemeName":"apiKey"}}},"servers":{"d5dd3c6d-4305-4406-a83e-e498a745a1bc":{"url":"https://app.vern.so/api/v1","description":"US-hosted accounts"},"25cf5952-e71f-4bbc-9ba4-bcf677ba9742":{"url":"https://au.app.vern.so/api/v1","description":"Australia-hosted accounts"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your Vern API key. Create one at Settings → API keys.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","description":"Your Vern API key. Create one at Settings → API keys.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"vern","siteName":"Vern Documentation","title":"Create or update the source connection - Vern Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T22:48:02.021Z","originalFileLocation":"api-reference/migrations/create-or-update-the-source-connection.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=\"Attach a live API source to the migration, or update it in place. credentials (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vern Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vern/MeorCT6aaGhS-RJw/_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/vern/MeorCT6aaGhS-RJw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vern/MeorCT6aaGhS-RJw/_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/vern/MeorCT6aaGhS-RJw/_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/vern/MeorCT6aaGhS-RJw/_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/vern/MeorCT6aaGhS-RJw/_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/vern/MeorCT6aaGhS-RJw/_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/vern/MeorCT6aaGhS-RJw/_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/vern/MeorCT6aaGhS-RJw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create or update the source connection - Vern Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Attach a live API source to the migration, or update it in place. credentials (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vern Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vern.mintlify.site/_mintlify/api/og/v2?division=Migrations\u0026amp;title=Create+or+update+the+source+connection\u0026amp;description=Attach+a+live+API+source+to+the+migration%2C+or+update+it+in+place.+%60credentials%60+%28optional+here%29+go+to+a+secured+vault+and+are+never+returned%3B+you+can+also+suppl\u0026amp;theme=36882be2d6b82b8fbd5b4ff7\u0026amp;signature=858b5a8e34bd0ce23b1547be435ed14d1a11e23c32244db7586ddcfa8a1e860b\">\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=\"Create or update the source connection - Vern Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Attach a live API source to the migration, or update it in place. credentials (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vern.mintlify.site/_mintlify/api/og/v2?division=Migrations\u0026amp;title=Create+or+update+the+source+connection\u0026amp;description=Attach+a+live+API+source+to+the+migration%2C+or+update+it+in+place.+%60credentials%60+%28optional+here%29+go+to+a+secured+vault+and+are+never+returned%3B+you+can+also+suppl\u0026amp;theme=36882be2d6b82b8fbd5b4ff7\u0026amp;signature=858b5a8e34bd0ce23b1547be435ed14d1a11e23c32244db7586ddcfa8a1e860b\">\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/vern/MeorCT6aaGhS-RJw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vern Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#10B981\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/migrations/create-or-update-the-source-connection.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vern.so/#organization\",\"name\":\"Vern Documentation\",\"url\":\"https://docs.vern.so\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vern/xEWEVl-f4WbHT-6k/logo/light.svg?fit=max\u0026auto=format\u0026n=xEWEVl-f4WbHT-6k\u0026q=85\u0026s=0935c9d27922ebd917cfce0dcb725e8c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vern.so#website\",\"name\":\"Vern Documentation\",\"url\":\"https://docs.vern.so\",\"publisher\":{\"@id\":\"https://docs.vern.so/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection#webpage\",\"url\":\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection\",\"name\":\"Create or update the source connection\",\"description\":\"Attach a live API source to the migration, or update it in place. credentials (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.\",\"dateModified\":\"2026-11-07T22:48:02.021Z\",\"isPartOf\":{\"@id\":\"https://docs.vern.so#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Migrations\",\"item\":\"https://docs.vern.so/api-reference/migrations/create-a-migration\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create or update the source connection\",\"item\":\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection#apireference\",\"headline\":\"Create or update the source connection\",\"name\":\"Create or update the source connection\",\"description\":\"Attach a live API source to the migration, or update it in place. credentials (optional here) go to a secured vault and are never returned; you can also supply them later via Submit credentials.\",\"url\":\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vern.so/api-reference/migrations/create-or-update-the-source-connection#webpage\"},\"dateModified\":\"2026-11-07T22:48:02.021Z\",\"publisher\":{\"@id\":\"https://docs.vern.so/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vern.so#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vern Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vern Documentation","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/help-center/get-started/introduction"}]},{"tab":"Developer","icon":"terminal","pages":[{"title":"Developer","href":"/migration-api/introduction"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Catalog","pages":[{"title":"List sources","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /sources","href":"/api-reference/catalog/list-sources"},{"title":"Update a source","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /sources/{source}","href":"/api-reference/catalog/update-a-source"},{"title":"Pin a source's recipe","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /sources/{source}/pin","href":"/api-reference/catalog/pin-a-sources-recipe"},{"title":"List templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /templates","href":"/api-reference/catalog/list-templates"},{"title":"Get a template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /templates/{template_slug}","href":"/api-reference/catalog/get-a-template"},{"title":"Update a template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /templates/{template_slug}","href":"/api-reference/catalog/update-a-template"},{"title":"Read source knowledge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /sources/{source}/knowledge","href":"/api-reference/knowledge/read-source-knowledge"},{"title":"Replace source knowledge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /sources/{source}/knowledge","href":"/api-reference/knowledge/replace-source-knowledge"}]},{"group":"Migrations","pages":[{"title":"Create a migration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /migrations","href":"/api-reference/migrations/create-a-migration"},{"title":"Mint signed upload URLs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /migrations/{migration_id}/files","href":"/api-reference/migrations/mint-signed-upload-urls"},{"title":"List uploaded files","description":"List the customer-uploaded files for the migration.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/files","href":"/api-reference/migrations/list-uploaded-files"},{"title":"Create or update the source connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /migrations/{migration_id}/source-connection","href":"/api-reference/migrations/create-or-update-the-source-connection"},{"title":"Get the source connection","description":"Read the migration's live API source connection, or 404 if none is configured. Never returns secret values — `creds_configured` reports whether credentials are on file.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/source-connection","href":"/api-reference/migrations/get-the-source-connection"},{"title":"Delete the source connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /migrations/{migration_id}/source-connection","href":"/api-reference/migrations/delete-the-source-connection"},{"title":"Read customer knowledge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/knowledge","href":"/api-reference/knowledge/read-customer-knowledge"},{"title":"Replace customer knowledge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /migrations/{migration_id}/knowledge","href":"/api-reference/knowledge/replace-customer-knowledge"}]},{"group":"Runs","pages":[{"title":"Start a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /migrations/{migration_id}/runs","href":"/api-reference/runs/start-a-run"},{"title":"Poll a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/runs/{run_id}","href":"/api-reference/runs/poll-a-run"},{"title":"Cancel a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /migrations/{migration_id}/runs/{run_id}","href":"/api-reference/runs/cancel-a-run"},{"title":"Answer a blocked run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /migrations/{migration_id}/runs/{run_id}/messages","href":"/api-reference/runs/answer-a-blocked-run"},{"title":"Submit source credentials","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /migrations/{migration_id}/runs/{run_id}/credentials","href":"/api-reference/runs/submit-source-credentials"},{"title":"Get the preview","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/preview","href":"/api-reference/runs/get-the-preview"},{"title":"Get the thread (snapshot)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/thread","href":"/api-reference/runs/get-the-thread-snapshot"},{"title":"Stream the thread (SSE)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/thread/stream","href":"/api-reference/runs/stream-the-thread-sse"},{"title":"Get the session log","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/log","href":"/api-reference/log/get-the-session-log"}]},{"group":"Export","pages":[{"title":"Export a sheet as CSV","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/exports/{file}","href":"/api-reference/export/export-a-sheet-as-csv"},{"title":"Start an export","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /migrations/{migration_id}/exports","href":"/api-reference/exports/start-an-export"},{"title":"Poll an export job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /migrations/{migration_id}/exports/jobs/{job_id}","href":"/api-reference/exports/poll-an-export-job"}]}]}]},"basePath":"","title":"Create or update the source connection - Vern Documentation","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-Dr40SSJq.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}