{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Knot","description":"Guides and API reference for integrating Knot products, such as CardSwitcher and Supernova","colors":{"primary":"#0F0E0E","light":"#D8D8D8","dark":"#0F0E0E"},"logo":{"light":"https://mintcdn.com/knot/VBuG2prLV3p6xOTo/logo/light.svg?fit=max\u0026auto=format\u0026n=VBuG2prLV3p6xOTo\u0026q=85\u0026s=fd06fd47577a90c8e224072b4be0e5dd","dark":"https://mintcdn.com/knot/VBuG2prLV3p6xOTo/logo/dark.svg?fit=max\u0026auto=format\u0026n=VBuG2prLV3p6xOTo\u0026q=85\u0026s=3ec182904f4fcae0296bd34329d1ffa0","href":"https://www.knotapi.com"},"favicon":"https://mintcdn.com/knot/VBuG2prLV3p6xOTo/favicon.svg?fit=max\u0026auto=format\u0026n=VBuG2prLV3p6xOTo\u0026q=85\u0026s=47782d8aa08991b4c5e03be1fb07dcd0","api":{"openapi":"api-reference/openapi.json"},"navbar":{"links":[{"href":"https://knotapi.com/careers","label":"We're hiring"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.knotapi.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/knotapi","x":"https://x.com/KnotAPIs"},"links":[{"header":"Products","items":[{"label":"CardSwitcher™","href":"https://www.knotapi.com/cardswitcher"},{"label":"TransactionLink™","href":"https://www.knotapi.com/txn-link"},{"label":"AgenticShopping™","href":"https://www.knotapi.com/agentic-shopping"},{"label":"AccountUpdater™","href":"https://www.knotapi.com/accountupdater"}]},{"header":"Use Cases","items":[{"label":"Personal Banking","href":"https://www.knotapi.com/personal-banking"},{"label":"Business Banking","href":"https://www.knotapi.com/business-banking"},{"label":"Merchants","href":"https://www.knotapi.com/merchants"},{"label":"BaaS","href":"https://www.knotapi.com/baas"}]},{"header":"Company","items":[{"label":"About Us","href":"https://www.knotapi.com/about-us"},{"label":"Trust Center","href":"https://trust.knotapi.com/"},{"label":"Contact","href":"https://www.knotapi.com/contact"},{"label":"Careers","href":"https://knotapi.com/careers"}]},{"header":"Legal","items":[{"label":"Terms \u0026 Conditions","href":"https://www.knotapi.com/terms"},{"label":"Privacy Policy","href":"https://www.knotapi.com/privacy"}]}]},"search":{"prompt":"Search or ask AI..."},"seo":{"organization":{"name":"Knot","url":"https://www.knotapi.com","sameAs":["https://www.linkedin.com/company/knotapi","https://x.com/KnotAPIs"]}},"fonts":{"heading":{"family":"Geist","weight":500},"body":{"family":"Geist","weight":400}},"styling":{"codeblocks":"system","latex":false},"integrations":{"segment":{"key":"2VQVWDiEQctuTfDIREdqA3l0KGlREyN5"}},"errors":{"404":{"redirect":false,"title":"Hello there...","description":"This page doesn’t exist, but your next opportunity might 👀. Check out [open roles at Knot](https://knotapi.com/careers). Looking for documentation? Start at the [introduction](/), browse the [documentation index (llms.txt)](/llms.txt) or [sitemap](/sitemap.xml), or [contact Knot](https://www.knotapi.com/contact/)."}},"contextual":{"options":["assistant","copy","add-mcp","chatgpt","claude","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"knot","hasAudioNarration":true,"actualSubdomain":"knot","customDomains":["docs.knotapi.com"],"gitSource":{"type":"github","owner":"millionscard","repo":"knot-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae5e9f23badfbce406c289d","collectionId":"38f901f9-21df-4d2e-a4e4-73c005aad25f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae5e9f23badfbce406c289d"},"feedback":{"edits":false,"thumbs":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae5e9f23badfbce406c289d","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Docs","count":76},{"language":"default","tag":"API Reference","count":48},{"language":"default","tag":"Webhook Events","count":28},{"language":"default","tag":"CardSwitcher","count":19},{"language":"default","tag":"TransactionLink","count":16},{"language":"default","tag":"Merchant Account Linking","count":13},{"language":"default","tag":"SubscriptionManager","count":12},{"language":"default","tag":"SDK","count":12},{"language":"default","tag":"Shopping","count":9},{"language":"default","tag":"Use Cases","count":8}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":false}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"deflection":{"enabled":true,"email":"product@knotapi.com"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6900107fa0d9fd2c40a2a17e","deploymentId":"67259f59f39b3bc1a898c425","questionText":"How do I get a list of available merchants?","status":"active","generatedBy":"manual","createdAt":"2025-10-28T00:38:23.158Z","updatedAt":"2025-10-28T00:38:23.158Z","__v":0},{"_id":"69001016a0d9fd2c40a27dce","deploymentId":"67259f59f39b3bc1a898c425","questionText":"How do I send card data to Knot?","status":"active","generatedBy":"manual","createdAt":"2025-10-28T00:36:38.949Z","updatedAt":"2025-10-28T00:36:38.949Z","__v":0},{"_id":"69000fe3a0d9fd2c40a26975","deploymentId":"67259f59f39b3bc1a898c425","questionText":"How do I create a session?","status":"active","generatedBy":"manual","createdAt":"2025-10-28T00:35:47.577Z","updatedAt":"2025-10-28T00:35:47.577Z","__v":0}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"html[data-current-path=\"/api-reference/work-at-knot/apply\"] #sidebar{display:none}html[data-current-path=\"/api-reference/work-at-knot/apply\"] #content-area{margin-left:0;padding-left:0;max-width:100%}"}],"page":{"pagePath":"api-reference/products/card-switcher/switch-card","slug":"/api-reference/products/card-switcher/switch-card","pageMetadata":{"title":"Switch Card","openapi":"api-reference/openapi_secure.json POST /card","description":"Switch a card in a user's merchant account.","href":"/api-reference/products/card-switcher/switch-card"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Switch a card in a user’s merchant account.\"\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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Switch Card","openapi":"api-reference/openapi_secure.json POST /card","description":"Switch a card in a user's merchant account.","href":"/api-reference/products/card-switcher/switch-card"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"card_switch","summary":"Switch Card","description":"Switch a card in a user's merchant account.","requestBody":"e9976eee-32dc-4560-b2bd-1fabcf5b02e7","responses":{"200":"cd11f5af-1df8-43a6-858d-ce0112eda985","400":"fbbb3712-348c-49e4-8510-1fdbabf831bb","401":"ecb2bc9b-88f4-427f-af1b-3c3a4563e1ce","403":"5fd7cf52-d17a-4284-9c65-e14ec518eb9a"},"method":"post","type":"path","servers":["45550944-dcad-4c31-8e0a-c3863c100aa4"],"security":["0ddd9799-1aca-4fe9-9801-a32da9cdad0a"],"path":"/card","baseUrlOptions":["https://secure.development.knotapi.com"],"title":"Switch Card","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"The input parameters required for switching a card.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"CardSwitcher","required":["user","card","task_id"],"properties":{"user":{"type":"object","description":"","properties":{"name":{"type":"object","description":"","properties":{"first_name":{"type":"string","maxLength":255,"description":"User's first name.","example":"Ada","isRequired":true,"uniqueKey":"oneOf.0.user.name.first_name","typeLabel":"string"},"last_name":{"type":"string","maxLength":255,"description":"User's last name.","example":"Lovelace","isRequired":true,"uniqueKey":"oneOf.0.user.name.last_name","typeLabel":"string"}},"required":["first_name","last_name"],"isRequired":true,"uniqueKey":"oneOf.0.user.name","typeLabel":"object"},"phone_number":{"type":"string","description":"User's phone number in E.164 format.","example":"+11234567890","isRequired":true,"uniqueKey":"oneOf.0.user.phone_number","typeLabel":"string"},"address":{"type":"object","description":"","properties":{"street":{"type":"string","maxLength":46,"description":"First line of the user's billing address.","example":"100 Main Street","isRequired":true,"uniqueKey":"oneOf.0.user.address.street","typeLabel":"string"},"city":{"type":"string","maxLength":32,"description":"City portion of the user's billing address.","example":"New York","isRequired":true,"uniqueKey":"oneOf.0.user.address.city","typeLabel":"string"},"region":{"type":"string","description":"Region portion of the user's billing address, usually a state abbreviation. Must be an ISO 3166-2 sub-division code.","example":"NY","isRequired":true,"uniqueKey":"oneOf.0.user.address.region","typeLabel":"string"},"postal_code":{"type":"string","maxLength":10,"minLength":5,"description":"Postal code of the user's billing address.","example":"12345","isRequired":true,"uniqueKey":"oneOf.0.user.address.postal_code","typeLabel":"string"},"country":{"type":"string","description":"Country portion of the user's billing address. Must be an ISO 3166-1 alpha-2 code.","example":"US","isRequired":true,"uniqueKey":"oneOf.0.user.address.country","typeLabel":"string"},"street2":{"type":"string","maxLength":46,"description":"Second line of the user's billing address (e.g apt. #).","example":"#100","uniqueKey":"oneOf.0.user.address.street2","typeLabel":"string"}},"required":["street","city","region","postal_code","country"],"isRequired":true,"uniqueKey":"oneOf.0.user.address","typeLabel":"object"}},"required":["name","phone_number","address"],"isRequired":true,"uniqueKey":"oneOf.0.user","typeLabel":"object"},"card":{"type":"object","description":"","properties":{"number":{"type":"string","description":"User's valid card number without spaces or hyphens.","example":"4242424242424242","isRequired":true,"uniqueKey":"oneOf.0.card.number","typeLabel":"string"},"expiration":{"type":"string","description":"User's card expiration date. Must be MM/YYYY or MM/YY format (e.g. 08/2027).","example":"08/2025","isRequired":true,"uniqueKey":"oneOf.0.card.expiration","typeLabel":"string"},"cvv":{"type":"string","maxLength":4,"description":"User's card verification value.","example":"123","isRequired":true,"uniqueKey":"oneOf.0.card.cvv","typeLabel":"string"}},"required":["number","expiration","cvv"],"isRequired":true,"uniqueKey":"oneOf.0.card","typeLabel":"object"},"task_id":{"type":"string","description":"`task_id` value provided in the [`AUTHENTICATED`](/link/webhook-events/authenticated) webhook.","example":"123456","isRequired":true,"uniqueKey":"oneOf.0.task_id","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"CardSwitcher · object"},{"type":"object","title":"CardUpdater","required":["user","card","external_user_id","merchant_id"],"properties":{"user":{"type":"object","description":"","properties":{"name":{"type":"object","description":"","properties":{"first_name":{"type":"string","maxLength":255,"description":"User's first name.","example":"Ada","isRequired":true,"uniqueKey":"oneOf.1.user.name.first_name","typeLabel":"string"},"last_name":{"type":"string","maxLength":255,"description":"User's last name.","example":"Lovelace","isRequired":true,"uniqueKey":"oneOf.1.user.name.last_name","typeLabel":"string"}},"required":["first_name","last_name"],"isRequired":true,"uniqueKey":"oneOf.1.user.name","typeLabel":"object"},"phone_number":{"type":"string","description":"User's phone number in E.164 format.","example":"+11234567890","isRequired":true,"uniqueKey":"oneOf.1.user.phone_number","typeLabel":"string"},"address":{"type":"object","description":"","properties":{"street":{"type":"string","maxLength":46,"description":"First line of the user's billing address.","example":"100 Main Street","isRequired":true,"uniqueKey":"oneOf.1.user.address.street","typeLabel":"string"},"city":{"type":"string","maxLength":32,"description":"City portion of the user's billing address.","example":"New York","isRequired":true,"uniqueKey":"oneOf.1.user.address.city","typeLabel":"string"},"region":{"type":"string","description":"Region portion of the user's billing address, usually a state abbreviation. Must be an ISO 3166-2 sub-division code.","example":"NY","isRequired":true,"uniqueKey":"oneOf.1.user.address.region","typeLabel":"string"},"postal_code":{"type":"string","maxLength":10,"minLength":5,"description":"Postal code of the user's billing address.","example":"12345","isRequired":true,"uniqueKey":"oneOf.1.user.address.postal_code","typeLabel":"string"},"country":{"type":"string","description":"Country portion of the user's billing address. Must be an ISO 3166-1 alpha-2 code.","example":"US","isRequired":true,"uniqueKey":"oneOf.1.user.address.country","typeLabel":"string"},"street2":{"type":"string","maxLength":46,"description":"Second line of the user's billing address (e.g apt. #).","example":"#100","uniqueKey":"oneOf.1.user.address.street2","typeLabel":"string"}},"required":["street","city","region","postal_code","country"],"isRequired":true,"uniqueKey":"oneOf.1.user.address","typeLabel":"object"}},"required":["name","phone_number","address"],"isRequired":true,"uniqueKey":"oneOf.1.user","typeLabel":"object"},"card":{"type":"object","description":"","properties":{"number":{"type":"string","description":"User's valid card number without spaces or hyphens.","example":"4242424242424242","isRequired":true,"uniqueKey":"oneOf.1.card.number","typeLabel":"string"},"expiration":{"type":"string","description":"User's card expiration date. Must be MM/YYYY or MM/YY format (e.g. 08/2027).","example":"08/2025","isRequired":true,"uniqueKey":"oneOf.1.card.expiration","typeLabel":"string"},"cvv":{"type":"string","maxLength":4,"description":"User's card verification value.","example":"123","isRequired":true,"uniqueKey":"oneOf.1.card.cvv","typeLabel":"string"}},"required":["number","expiration","cvv"],"isRequired":true,"uniqueKey":"oneOf.1.card","typeLabel":"object"},"external_user_id":{"type":"string","description":"Your unique identifier for the user.","example":"abc123","isRequired":true,"uniqueKey":"oneOf.1.external_user_id","typeLabel":"string"},"merchant_id":{"type":"integer","description":"Unique identifier for the merchant.","example":46,"isRequired":true,"uniqueKey":"oneOf.1.merchant_id","typeLabel":"integer"},"card_name":{"type":"string","description":"Name of the card. Learn more [here](/sdk/ios#customerconfiguration).","example":"My Credit Card","uniqueKey":"oneOf.1.card_name","typeLabel":"string"},"customer_name":{"type":"string","description":"Name of the customer. Learn more [here](/sdk/ios#customerconfiguration).","example":"John Doe","uniqueKey":"oneOf.1.customer_name","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"CardUpdater · object"}],"uniqueKey":"","typeLabel":"CardSwitcher · object | CardUpdater · object"},"examples":{"Example":{"title":"Example","value":{"user":{"name":{"first_name":"Ada","last_name":"Lovelace"},"phone_number":"+11234567890","address":{"street":"100 Main Street","city":"New York","region":"NY","postal_code":"12345","country":"US","street2":"#100"}},"card":{"number":"4242424242424242","expiration":"08/2025","cvv":"123"},"task_id":"123456"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"cd11f5af-1df8-43a6-858d-ce0112eda985":{"description":"Successful request.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Success message.","example":"Success","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Success"}}},"exampleType":"generated"}},"exampleType":"generated"},"fbbb3712-348c-49e4-8510-1fdbabf831bb":{"description":"Bad request.","content":{"application/json":{"schema":{"type":"object","properties":{"error_type":{"type":"string","description":"Type of error.","example":"INVALID_REQUEST","uniqueKey":"error_type","typeLabel":"string"},"error_code":{"type":"string","description":"Error code.","example":"INVALID_FIELD","uniqueKey":"error_code","typeLabel":"string"},"error_message":{"type":"string","description":"Detailed error message.","example":"The user.name.first_name must not be greater than 255 characters.","uniqueKey":"error_message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"UserFieldRequired":{"title":"UserFieldRequired","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The user.phone number is required."}},"CardNumberNotNumeric":{"title":"CardNumberNotNumeric","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The card.number must be numeric."}},"CardNumberTooLong":{"title":"CardNumberTooLong","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The card.number is too long for card type."}},"CardNumberTooShort":{"title":"CardNumberTooShort","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The card.number is too short for card type."}},"CardNumberInvalid":{"title":"CardNumberInvalid","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The card.number is invalid and does not pass the Luhn check."}},"CVVNotNumeric":{"title":"CVVNotNumeric","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The card.cvv must be numeric."}},"CVVTooLong":{"title":"CVVTooLong","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The card.cvv is too long for card type."}},"CVVTooShort":{"title":"CVVTooShort","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The card.cvv is too short for card type."}},"CardExpirationInvalid":{"title":"CardExpirationInvalid","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The card.expiration should be in MM/YYYY or MM/YY format."}},"CardExpired":{"title":"CardExpired","value":{"error_type":"INVALID_REQUEST","error_code":"INVALID_FIELD","error_message":"The card is expired."}},"OngoingOperation":{"title":"OngoingOperation","value":{"error_type":"MERCHANT_ACCOUNT_ERROR","error_code":"ONGOING_OPERATION","error_message":"An existing operation is in progress."}}},"exampleType":"examples"}},"exampleType":"examples"},"ecb2bc9b-88f4-427f-af1b-3c3a4563e1ce":{"description":"Unauthorized request.","content":{"application/json":{"schema":{"type":"object","properties":{"error_type":{"type":"string","description":"Type of error.","example":"INVALID_REQUEST","uniqueKey":"error_type","typeLabel":"string"},"error_code":{"type":"string","description":"Error code.","example":"INVALID_FIELD","uniqueKey":"error_code","typeLabel":"string"},"error_message":{"type":"string","description":"Detailed error message.","example":"The user.name.first_name must not be greater than 255 characters.","uniqueKey":"error_message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"AuthFailed":{"title":"AuthFailed","value":{"error_type":"INVALID_INPUT","error_code":"INVALID_API_KEYS","error_message":"Invalid client_id or secret provided."}}},"exampleType":"examples"}},"exampleType":"examples"},"5fd7cf52-d17a-4284-9c65-e14ec518eb9a":{"description":"Forbidden request.","content":{"application/json":{"schema":{"type":"object","properties":{"error_type":{"type":"string","description":"Type of error.","example":"INVALID_REQUEST","uniqueKey":"error_type","typeLabel":"string"},"error_code":{"type":"string","description":"Error code.","example":"INVALID_FIELD","uniqueKey":"error_code","typeLabel":"string"},"error_message":{"type":"string","description":"Detailed error message.","example":"The user.name.first_name must not be greater than 255 characters.","uniqueKey":"error_message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"NoAccess":{"title":"NoAccess","value":{"error_type":"INVALID_REQUEST","error_code":"NO_ACCESS","error_message":"Please contact Knot for access to this endpoint."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"0ddd9799-1aca-4fe9-9801-a32da9cdad0a":{"basicAuth":{"type":"http","scheme":"basic","scopes":[]}}},"servers":{"45550944-dcad-4c31-8e0a-c3863c100aa4":{"url":"https://secure.development.knotapi.com","description":"Development server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[]},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basicAuth","name":"Authorization"}],"title":"basicAuth"}]},"originalFileLocation":"api-reference/openapi_secure.json"},"subdomain":"knot","siteName":"Knot","title":"Switch Card - Knot","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-31T17:11:43.070Z","originalFileLocation":"api-reference/products/card-switcher/switch-card.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=\"Switch a card in a user\u0026#x27;s merchant account.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Knot\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_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/knot/X2cfOEMCNQ4RTMjp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_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/knot/X2cfOEMCNQ4RTMjp/_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/knot/X2cfOEMCNQ4RTMjp/_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/knot/X2cfOEMCNQ4RTMjp/_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/knot/X2cfOEMCNQ4RTMjp/_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/knot/X2cfOEMCNQ4RTMjp/_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/knot/X2cfOEMCNQ4RTMjp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Switch Card - Knot\">\u003cmeta data-mint-head property=\"og:description\" content=\"Switch a card in a user\u0026#x27;s merchant account.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Knot\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://knot.mintlify.app/_mintlify/api/og/v2?division=CardSwitcher\u0026amp;title=Switch+Card\u0026amp;description=Switch+a+card+in+a+user%27s+merchant+account.\u0026amp;theme=c2017d1867bb9f3af1e4a591\u0026amp;signature=d44562c65c8c7516b829b52138a79ca80d4c774218caa1a1ee22721096356a9f\">\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=\"Switch Card - Knot\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Switch a card in a user\u0026#x27;s merchant account.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://knot.mintlify.app/_mintlify/api/og/v2?division=CardSwitcher\u0026amp;title=Switch+Card\u0026amp;description=Switch+a+card+in+a+user%27s+merchant+account.\u0026amp;theme=c2017d1867bb9f3af1e4a591\u0026amp;signature=d44562c65c8c7516b829b52138a79ca80d4c774218caa1a1ee22721096356a9f\">\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/knot/X2cfOEMCNQ4RTMjp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Knot\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F0E0E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/products/card-switcher/switch-card.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.knotapi.com/#organization\",\"name\":\"Knot\",\"url\":\"https://www.knotapi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/knot/VBuG2prLV3p6xOTo/logo/light.svg?fit=max\u0026auto=format\u0026n=VBuG2prLV3p6xOTo\u0026q=85\u0026s=fd06fd47577a90c8e224072b4be0e5dd\"},\"sameAs\":[\"https://www.linkedin.com/company/knotapi\",\"https://x.com/KnotAPIs\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.knotapi.com#website\",\"name\":\"Knot\",\"url\":\"https://docs.knotapi.com\",\"publisher\":{\"@id\":\"https://www.knotapi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card#webpage\",\"url\":\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card\",\"name\":\"Switch Card\",\"description\":\"Switch a card in a user's merchant account.\",\"dateModified\":\"2026-03-31T17:11:43.070Z\",\"isPartOf\":{\"@id\":\"https://docs.knotapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"CardSwitcher\",\"item\":\"https://docs.knotapi.com/api-reference/products/card-switcher/retrieve-jwk\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Switch Card\",\"item\":\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card#apireference\",\"headline\":\"Switch Card\",\"name\":\"Switch Card\",\"description\":\"Switch a card in a user's merchant account.\",\"url\":\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card\",\"mainEntityOfPage\":{\"@id\":\"https://docs.knotapi.com/api-reference/products/card-switcher/switch-card#webpage\"},\"dateModified\":\"2026-03-31T17:11:43.070Z\",\"publisher\":{\"@id\":\"https://www.knotapi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.knotapi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Knot\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Knot","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Authentication","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"Versioning","href":"/api-reference/versioning"},{"title":"mTLS","href":"/api-reference/mTLS"}]},{"group":"Supernova","pages":[{"title":"Create MCP Token","openapi":"POST /mcp/tokens/create","href":"/api-reference/mcp-tokens/create-mcp-token"},{"title":"Revoke MCP Tokens","openapi":"POST /mcp/tokens/revoke","href":"/api-reference/mcp-tokens/revoke-mcp-tokens"}]},{"group":"Development","pages":[{"title":"Link Account","openapi":"POST /development/accounts/link","href":"/api-reference/development/link-account"}]},{"group":"Sessions","pages":[{"title":"Create Session","openapi":"POST /session/create","href":"/api-reference/sessions/create-session"},{"title":"Extend Session","openapi":"POST /session/extend","href":"/api-reference/sessions/extend-session"}]},{"group":"CardSwitcher","pages":[{"title":"Retrieve JWK","openapi":"GET /jwe/key","href":"/api-reference/products/card-switcher/retrieve-jwk"},{"title":"Switch Card JWE","openapi":"api-reference/openapi.json POST /card","description":"Switch a card in a user's merchant account.","href":"/api-reference/products/card-switcher/switch-card-jwe"},{"title":"Switch Card","openapi":"api-reference/openapi_secure.json POST /card","href":"/api-reference/products/card-switcher/switch-card"},{"title":"Switch Bank Account JWE","openapi":"api-reference/openapi.json POST /bank-account","description":"Switch a bank account in a user's merchant account.","href":"/api-reference/products/card-switcher/switch-bank-account-jwe"},{"title":"Create Knot Zero Link","openapi":"POST /zero-link/create","href":"/api-reference/products/card-switcher/create-knot-zero-link"},{"title":"Create Knot Zero Links (Batch)","openapi":"POST /zero-link/batch/create","href":"/api-reference/products/card-switcher/create-knot-zero-links-batch"},{"title":"Revoke Knot Zero Links","openapi":"POST /zero-link/revoke","href":"/api-reference/products/card-switcher/revoke-knot-zero-links"}]},{"group":"TransactionLink","pages":[{"title":"The Transaction Object","href":"/api-reference/products/transaction-link/transaction-object"},{"title":"Sync Transactions","openapi":"POST /transactions/sync","href":"/api-reference/products/transaction-link/sync"},{"title":"Get Transaction By ID","openapi":"GET /transactions/{id}","href":"/api-reference/products/transaction-link/get-by-id"},{"title":"Refresh Transactions","openapi":"POST /transactions/refresh","href":"/api-reference/products/transaction-link/refresh"}]},{"group":"SubscriptionManager","pages":[{"title":"The Subscription Object","href":"/api-reference/products/subscriptions/subscription-object"},{"title":"Get Subscription By ID","openapi":"GET /subscriptions/{id}","href":"/api-reference/products/subscriptions/get-by-id"},{"title":"List Subscriptions","openapi":"POST /subscriptions/list","href":"/api-reference/products/subscriptions/list"},{"title":"Refresh Subscriptions","openapi":"POST /subscriptions/refresh","href":"/api-reference/products/subscriptions/refresh"},{"title":"Cancel Subscription By ID","openapi":"POST /subscriptions/{id}/cancel","href":"/api-reference/products/subscriptions/cancel"},{"title":"Cancel Subscription By Account","openapi":"POST /subscriptions/cancel","href":"/api-reference/products/subscriptions/cancel-by-account"}]},{"group":"Shopping","pages":[{"title":"Sync Cart","openapi":"POST /cart","href":"/api-reference/products/shopping/sync-cart"},{"title":"Checkout","openapi":"POST /cart/checkout","href":"/api-reference/products/shopping/checkout"}]},{"group":"Merchants","pages":[{"title":"List Merchants","openapi":"POST /merchant/list","href":"/api-reference/merchants/list-merchants"}]},{"group":"Merchant Accounts","pages":[{"title":"Get Merchant Accounts","openapi":"GET /accounts/get","href":"/api-reference/accounts/get-accounts"},{"title":"Unlink Merchant Account","openapi":"POST /accounts/unlink","href":"/api-reference/accounts/unlink-account"}]},{"group":"Detected Accounts","pages":[{"title":"Detect Accounts","openapi":"POST /detect","href":"/api-reference/products/detect/detect-accounts"},{"title":"List Detected Accounts","openapi":"POST /detected-accounts/list","href":"/api-reference/products/detect/list-detected-accounts"},{"title":"Search Detected Accounts","openapi":"POST /detected-accounts/search","href":"/api-reference/products/detect/search-detected-accounts"},{"title":"Sync Detected Accounts","openapi":"POST /detected-accounts/sync","href":"/api-reference/products/detect/sync-detected-accounts"}]},{"group":"Users","pages":[{"title":"Delete User \u0026 Data","openapi":"POST /user/delete","href":"/api-reference/users/delete-user-and-data"}]},{"group":"Audit Logs","pages":[{"title":"Get Audit Logs","openapi":"GET /audit_logs","href":"/api-reference/audit-logs/get-audit-logs"}]},{"group":"Agent Authorization","pages":[{"title":"Agent authorization","sidebarTitle":"Overview","href":"/api-reference/agent-authorization/overview"},{"title":"Request Device Code","openapi":"POST /oauth/device/code","href":"/api-reference/agent-authorization/request-device-code"},{"title":"Request Access Token","openapi":"POST /oauth/token","href":"/api-reference/agent-authorization/request-access-token"}]},{"group":"Webhook Endpoints","pages":[{"title":"Webhook Endpoint Object","href":"/api-reference/webhook-endpoints/webhook-endpoint-object"},{"title":"Create Webhook Endpoint","openapi":"POST /webhook-endpoints/create","href":"/api-reference/webhook-endpoints/create"},{"title":"Get Webhook Endpoint By ID","openapi":"GET /webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/get-by-id"},{"title":"List Webhook Endpoints","openapi":"POST /webhook-endpoints/list","href":"/api-reference/webhook-endpoints/list"},{"title":"Update Webhook Endpoint","openapi":"POST /webhook-endpoints/{id}/update","href":"/api-reference/webhook-endpoints/update"},{"title":"Delete Webhook Endpoint","openapi":"POST /webhook-endpoints/{id}/delete","href":"/api-reference/webhook-endpoints/delete"}]},{"group":"Request Logs","pages":[{"title":"Request Log Object","href":"/api-reference/request-logs/request-log-object"},{"title":"List Request Logs","openapi":"GET /request-logs","href":"/api-reference/request-logs/list"},{"title":"Get Request Log By ID","openapi":"GET /request-logs/{id}","href":"/api-reference/request-logs/get-by-id"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/product-updates"}]}]},"basePath":"","title":"Switch Card - Knot","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","2bfc744e19","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","NarrationPlayer-Cu2BQT2J.js","types-CiTgMxws.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}