v1 is deprecated — use the v2 endpoint instead. Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don’t create duplicate items.
Bearer authentication header of the form Bearer <token>, where <token> is an API key from the API Integration section of your dashboard. Keys are scoped to the company they are generated in — for testing, add a separate test company and generate the key there, so requests never touch your real books.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Swipe","colors":{"primary":"#2045D1","light":"#538DFF","dark":"#2045D1"},"logo":{"light":"https://mintcdn.com/swipe/DQkaOg10KeYQlKIu/logo/logo_g_light.webp?fit=max\u0026auto=format\u0026n=DQkaOg10KeYQlKIu\u0026q=85\u0026s=44d5e4b626518cb3542e8ef16e85f182","dark":"https://mintcdn.com/swipe/DQkaOg10KeYQlKIu/logo/logo_g_dark.webp?fit=max\u0026auto=format\u0026n=DQkaOg10KeYQlKIu\u0026q=85\u0026s=84cf20e2bc4f85a8fea2938d2f43412e","href":"/"},"favicon":"https://mintcdn.com/swipe/ZOyvFX50eH4DT_Wr/favicon.svg?fit=max\u0026auto=format\u0026n=ZOyvFX50eH4DT_Wr\u0026q=85\u0026s=9f4476cef1667d0c527f72dd6036726b","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"navbar":{"links":[{"href":"https://app.getswipe.in/user?tab=api_integration","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.getswipe.in"}},"footer":{"socials":{"x":"https://twitter.com/swipebilling","instagram":"https://www.instagram.com/swipebilling","linkedin":"https://www.linkedin.com/company/swipebilling"}},"search":{"prompt":"Search the Swipe API docs..."},"seo":{"metatags":{"og:site_name":"Swipe API Documentation","og:type":"website"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Run in Postman","icon":{"style":"thin","name":"user-astronaut"},"href":"https://god.gw.postman.com/run-collection/43895811-b7327b9d-1e50-4fed-af6f-660a918aa817?action=collection%2Ffork\u0026source=rip_markdown\u0026collection-url=entityId%3D43895811-b7327b9d-1e50-4fed-af6f-660a918aa817%26entityType%3Dcollection%26workspaceId%3D5d3fc3f0-668c-499e-833b-03222666ba2a"},{"anchor":"Blog","icon":"newspaper","href":"https://getswipe.in/blog"},{"anchor":"Community","icon":"slack","href":"https://community.getswipe.in/c/api-integration/14"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"swipe","hasAudioNarration":false,"actualSubdomain":"swipe","customDomains":["developers.getswipe.in"],"gitSource":{"type":"github","owner":"swipe-yc21","repo":"partner-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa158f50379420e6579534a","collectionId":"9e7e6d91-a01b-44eb-b79d-efe99a4644f3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa158f50379420e6579534a"},"entitlements":{},"buildId":"6aa158f50379420e6579534a","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Documentation","count":74},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Customers","count":7},{"language":"default","tag":"Customer","count":7},{"language":"default","tag":"Vendors","count":7},{"language":"default","tag":"Documents","count":6},{"language":"default","tag":"Products","count":6},{"language":"default","tag":"Product","count":6},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"Resources","count":4}]},"assistantConfig":{},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/product/update-items-mapping","slug":"/api-reference/product/update-items-mapping","pageMetadata":{"openapi":"post /v1/product/list","title":"Update items mapping","description":"**v1 is deprecated — use the v2 endpoint instead.** Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate items.","href":"/api-reference/product/update-items-mapping"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"v1 is deprecated — use the v2 endpoint instead.\"\n }), \" Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don’t create duplicate items.\"]\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":{"openapi":"post /v1/product/list","title":"Update items mapping","description":"**v1 is deprecated — use the v2 endpoint instead.** Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate items.","href":"/api-reference/product/update-items-mapping"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Update items mapping","operationId":"post_item_list","tags":["Product"],"requestBody":"a2830bf9-2629-4851-bd6a-fef0b3dce213","responses":{"200":"4ca9c9f3-9eda-4c7d-8680-694ed7b63f43","400":"416f115e-3f00-4db1-9301-9ce2bea6da4b","401":"c3bc609b-5a69-4f0e-9fd2-7c87ebe0aa5e","409":"1586f085-228f-47be-821a-3ffa226672e1","500":"f13f494d-2800-41ff-b012-94942e8feb8a"},"description":"**v1 is deprecated — use the v2 endpoint instead.** Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate items.","method":"post","type":"path","servers":["82b38fec-7303-4b6e-86bb-63d990b1e4ef"],"security":["13576f02-530d-4f08-aab7-91987ee153ab"],"path":"/v1/product/list","baseUrlOptions":["https://app.getswipe.in/api/partner"],"title":"Update items mapping","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"required":["item_mapping"],"properties":{"item_mapping":{"type":"array","items":{"required":["item_id","swipe_id"],"properties":{"item_id":{"type":"string","description":"Item ID","isRequired":true,"uniqueKey":"item_mapping.items.[INDEX].item_id","typeLabel":"string"},"swipe_id":{"type":"string","description":"Swipe ID","example":1,"isRequired":true,"uniqueKey":"item_mapping.items.[INDEX].swipe_id","typeLabel":"string"},"force_update":{"type":"boolean","description":"Updates even if the item id is already mapped with other swipe id, no item details will be updated","example":true,"uniqueKey":"item_mapping.items.[INDEX].force_update","typeLabel":"boolean"}},"type":"object","uniqueKey":"item_mapping.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"item_mapping","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"item_mapping":[{"item_id":"\u003cstring>","swipe_id":1,"force_update":true}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"4ca9c9f3-9eda-4c7d-8680-694ed7b63f43":{"description":"Updated successfully","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"Product added successfully","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Product added successfully"}}},"exampleType":"generated"}},"exampleType":"generated"},"416f115e-3f00-4db1-9301-9ce2bea6da4b":{"description":"Error in mapping Item List","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error_code":{"type":"string","description":"Error Code","example":"INVALID_PRODUCT_ID","uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","description":"Response message","example":"Error Message","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","description":"Validation errors","example":"List of errors","uniqueKey":"errors","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error_code":"INVALID_PRODUCT_ID","message":"Error Message","errors":"List of errors"}}},"exampleType":"generated"}},"exampleType":"generated"},"c3bc609b-5a69-4f0e-9fd2-7c87ebe0aa5e":{"description":"Unauthorized","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error_code":{"type":"string","description":"Error Code","example":"INVALID_PRODUCT_ID","uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","description":"Response message","example":"Error Message","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","description":"Validation errors","example":"List of errors","uniqueKey":"errors","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error_code":"INVALID_PRODUCT_ID","message":"Error Message","errors":"List of errors"}}},"exampleType":"generated"}},"exampleType":"generated"},"1586f085-228f-47be-821a-3ffa226672e1":{"description":"Error in mapping Item List","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"item_mapping":{"type":"array","items":{"required":["item_id","swipe_id"],"properties":{"item_id":{"type":"string","description":"Item ID","isRequired":true,"uniqueKey":"item_mapping.items.[INDEX].item_id","typeLabel":"string"},"swipe_id":{"type":"string","description":"Swipe ID","example":1,"isRequired":true,"uniqueKey":"item_mapping.items.[INDEX].swipe_id","typeLabel":"string"},"force_update":{"type":"boolean","description":"Updates even if the item id is already mapped with other swipe id, no item details will be updated","example":true,"uniqueKey":"item_mapping.items.[INDEX].force_update","typeLabel":"boolean"}},"type":"object","uniqueKey":"item_mapping.items.[INDEX]","typeLabel":"object"},"uniqueKey":"item_mapping","typeLabel":"object[]"},"duplicate_item_ids":{"type":"array","items":{"required":["item_id","swipe_id"],"properties":{"item_id":{"type":"string","description":"Item ID","isRequired":true,"uniqueKey":"duplicate_item_ids.items.[INDEX].item_id","typeLabel":"string"},"swipe_id":{"type":"string","description":"Swipe ID","example":1,"isRequired":true,"uniqueKey":"duplicate_item_ids.items.[INDEX].swipe_id","typeLabel":"string"},"force_update":{"type":"boolean","description":"Updates even if the item id is already mapped with other swipe id, no item details will be updated","example":true,"uniqueKey":"duplicate_item_ids.items.[INDEX].force_update","typeLabel":"boolean"}},"type":"object","uniqueKey":"duplicate_item_ids.items.[INDEX]","typeLabel":"object"},"uniqueKey":"duplicate_item_ids","typeLabel":"object[]"},"duplicate_swipe_ids":{"type":"array","items":{"required":["item_id","swipe_id"],"properties":{"item_id":{"type":"string","description":"Item ID","isRequired":true,"uniqueKey":"duplicate_swipe_ids.items.[INDEX].item_id","typeLabel":"string"},"swipe_id":{"type":"string","description":"Swipe ID","example":1,"isRequired":true,"uniqueKey":"duplicate_swipe_ids.items.[INDEX].swipe_id","typeLabel":"string"},"force_update":{"type":"boolean","description":"Updates even if the item id is already mapped with other swipe id, no item details will be updated","example":true,"uniqueKey":"duplicate_swipe_ids.items.[INDEX].force_update","typeLabel":"boolean"}},"type":"object","uniqueKey":"duplicate_swipe_ids.items.[INDEX]","typeLabel":"object"},"uniqueKey":"duplicate_swipe_ids","typeLabel":"object[]"},"not_found_swipe_ids":{"type":"array","items":{"required":["item_id","swipe_id"],"properties":{"item_id":{"type":"string","description":"Item ID","isRequired":true,"uniqueKey":"not_found_swipe_ids.items.[INDEX].item_id","typeLabel":"string"},"swipe_id":{"type":"string","description":"Swipe ID","example":1,"isRequired":true,"uniqueKey":"not_found_swipe_ids.items.[INDEX].swipe_id","typeLabel":"string"},"force_update":{"type":"boolean","description":"Updates even if the item id is already mapped with other swipe id, no item details will be updated","example":true,"uniqueKey":"not_found_swipe_ids.items.[INDEX].force_update","typeLabel":"boolean"}},"type":"object","uniqueKey":"not_found_swipe_ids.items.[INDEX]","typeLabel":"object"},"uniqueKey":"not_found_swipe_ids","typeLabel":"object[]"},"message":{"type":"string","example":"Item ID already mapped !","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"item_mapping":[{"item_id":"\u003cstring>","swipe_id":1,"force_update":true}],"duplicate_item_ids":[{"item_id":"\u003cstring>","swipe_id":1,"force_update":true}],"duplicate_swipe_ids":[{"item_id":"\u003cstring>","swipe_id":1,"force_update":true}],"not_found_swipe_ids":[{"item_id":"\u003cstring>","swipe_id":1,"force_update":true}],"message":"Item ID already mapped !"}}},"exampleType":"generated"}},"exampleType":"generated"},"f13f494d-2800-41ff-b012-94942e8feb8a":{"description":"Internal Server Error","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error_code":{"type":"string","description":"Error Code","example":"INVALID_PRODUCT_ID","uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","description":"Response message","example":"Error Message","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","description":"Validation errors","example":"List of errors","uniqueKey":"errors","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error_code":"INVALID_PRODUCT_ID","message":"Error Message","errors":"List of errors"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"13576f02-530d-4f08-aab7-91987ee153ab":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is an API key from the [API Integration](https://app.getswipe.in/user?tab=api_integration) section of your dashboard. Keys are scoped to the company they are generated in — for testing, [add a separate test company](https://community.getswipe.in/t/how-to-add-new-company-on-web/1191) and generate the key there, so requests never touch your real books.","scopes":[]}}},"servers":{"82b38fec-7303-4b6e-86bb-63d990b1e4ef":{"url":"https://app.getswipe.in/api/partner"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is an API key from the [API Integration](https://app.getswipe.in/user?tab=api_integration) section of your dashboard. Keys are scoped to the company they are generated in — for testing, [add a separate test company](https://community.getswipe.in/t/how-to-add-new-company-on-web/1191) and generate the key there, so requests never touch your real books.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is an API key from the [API Integration](https://app.getswipe.in/user?tab=api_integration) section of your dashboard. Keys are scoped to the company they are generated in — for testing, [add a separate test company](https://community.getswipe.in/t/how-to-add-new-company-on-web/1191) and generate the key there, so requests never touch your real books.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"swipe","siteName":"Swipe","title":"Update items mapping - Swipe","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference/product-v2/update-items-mapping","matchLevel":1},"v1 (Deprecated)":{"href":"/api-reference/product/update-items-mapping","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T07:51:51.964Z","originalFileLocation":"api-reference/product/update-items-mapping.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=\"v1 is deprecated — use the v2 endpoint instead. Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don\u0026#x27;t create duplicate items.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Swipe\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_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/swipe/c1cYpNBFxkNdbDrf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update items mapping - Swipe\">\u003cmeta data-mint-head property=\"og:description\" content=\"v1 is deprecated — use the v2 endpoint instead. Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don\u0026#x27;t create duplicate items.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Swipe API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.getswipe.in/api-reference/product/update-items-mapping\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://swipe.mintlify.app/_mintlify/api/og/v2?division=Product\u0026amp;title=Update+items+mapping\u0026amp;description=**v1+is+deprecated+%E2%80%94+use+the+v2+endpoint+instead.**+Re-links+your+item+IDs+to+existing+Swipe+records+in+bulk.+Use+this+after+changing+IDs+in+your+own+system%2C+so\u0026amp;theme=6f6d44835af80bcfb7f23dbb\u0026amp;signature=8d8851c0cdc675f60d170939dd6068798dec61efcaa6371145fc97d76aa148ea\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update items mapping - Swipe\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"v1 is deprecated — use the v2 endpoint instead. Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don\u0026#x27;t create duplicate items.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://swipe.mintlify.app/_mintlify/api/og/v2?division=Product\u0026amp;title=Update+items+mapping\u0026amp;description=**v1+is+deprecated+%E2%80%94+use+the+v2+endpoint+instead.**+Re-links+your+item+IDs+to+existing+Swipe+records+in+bulk.+Use+this+after+changing+IDs+in+your+own+system%2C+so\u0026amp;theme=6f6d44835af80bcfb7f23dbb\u0026amp;signature=8d8851c0cdc675f60d170939dd6068798dec61efcaa6371145fc97d76aa148ea\">\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/swipe/c1cYpNBFxkNdbDrf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Swipe\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2045D1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.getswipe.in/api-reference/product/update-items-mapping\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/product/update-items-mapping.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.getswipe.in/#organization\",\"name\":\"Swipe\",\"url\":\"https://developers.getswipe.in\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/swipe/DQkaOg10KeYQlKIu/logo/logo_g_light.webp?fit=max\u0026auto=format\u0026n=DQkaOg10KeYQlKIu\u0026q=85\u0026s=44d5e4b626518cb3542e8ef16e85f182\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.getswipe.in#website\",\"name\":\"Swipe\",\"url\":\"https://developers.getswipe.in\",\"publisher\":{\"@id\":\"https://developers.getswipe.in/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.getswipe.in/api-reference/product/update-items-mapping#webpage\",\"url\":\"https://developers.getswipe.in/api-reference/product/update-items-mapping\",\"name\":\"Update items mapping\",\"description\":\"v1 is deprecated — use the v2 endpoint instead. Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate items.\",\"dateModified\":\"2026-08-27T07:51:51.964Z\",\"isPartOf\":{\"@id\":\"https://developers.getswipe.in#website\"},\"breadcrumb\":{\"@id\":\"https://developers.getswipe.in/api-reference/product/update-items-mapping#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.getswipe.in/api-reference/product/update-items-mapping#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Product\",\"item\":\"https://developers.getswipe.in/api-reference/product/add-an-item\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update items mapping\",\"item\":\"https://developers.getswipe.in/api-reference/product/update-items-mapping\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.getswipe.in/api-reference/product/update-items-mapping#apireference\",\"headline\":\"Update items mapping\",\"name\":\"Update items mapping\",\"description\":\"v1 is deprecated — use the v2 endpoint instead. Re-links your item IDs to existing Swipe records in bulk. Use this after changing IDs in your own system, so future calls don't create duplicate items.\",\"url\":\"https://developers.getswipe.in/api-reference/product/update-items-mapping\",\"mainEntityOfPage\":{\"@id\":\"https://developers.getswipe.in/api-reference/product/update-items-mapping#webpage\"},\"dateModified\":\"2026-08-27T07:51:51.964Z\",\"publisher\":{\"@id\":\"https://developers.getswipe.in/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.getswipe.in#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Swipe\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Swipe","nav":{"global":{"anchors":[{"anchor":"Run in Postman","icon":{"style":"thin","name":"user-astronaut"},"href":"https://god.gw.postman.com/run-collection/43895811-b7327b9d-1e50-4fed-af6f-660a918aa817?action=collection%2Ffork\u0026source=rip_markdown\u0026collection-url=entityId%3D43895811-b7327b9d-1e50-4fed-af6f-660a918aa817%26entityType%3Dcollection%26workspaceId%3D5d3fc3f0-668c-499e-833b-03222666ba2a"},{"anchor":"Blog","icon":"newspaper","href":"https://getswipe.in/blog"},{"anchor":"Community","icon":"slack","href":"https://community.getswipe.in/c/api-integration/14"}]},"versions":[{"version":"v2","pages":[{"title":"v2","href":"/api-reference/product-v2/update-items-mapping"}]},{"version":"v1 (Deprecated)","anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Get Started","pages":[{"title":"Introduction","icon":"rocket","href":"/introduction"},{"title":"Quickstart","icon":"play","href":"/quickstart"},{"title":"Authentication","icon":"key","href":"/authentication"},{"title":"API Conventions","icon":"list-check","href":"/api-conventions"},{"title":"Build with AI","icon":"robot","href":"/build-with-ai"}]},{"group":"Guides","pages":[{"title":"Documents","icon":"file-invoice","href":"/document"},{"title":"Customers","icon":"users","href":"/customer"},{"title":"Vendors","icon":"building","href":"/vendor"},{"title":"Payments","icon":"credit-card","href":"/payment"},{"title":"Products","icon":"boxes-stacked","href":"/product"},{"title":"Inventory","icon":"warehouse","href":"/inventory"},{"title":"Subscriptions","icon":"repeat","href":"/subscriptions"},{"title":"E-Way Bills","icon":"truck-fast","href":"/ewaybills"},{"title":"E-Invoices","icon":"file-circle-check","href":"/einvoices"},{"title":"Webhooks","icon":"bolt","href":"/webhooks"}]},{"group":"Resources","pages":[{"title":"Error Codes","icon":"triangle-exclamation","href":"/api-reference/error-codes"},{"title":"Tax Codes (TDS \u0026 TCS)","icon":"percent","href":"/api-reference/tax-codes"},{"title":"Currencies, States \u0026 Countries","icon":"globe","href":"/api-reference/reference-data"},{"title":"Change Log","icon":"clock-rotate-left","href":"/api-reference/change-log"}]},{"group":"Document","pages":[{"openapi":"post /v1/doc","title":"Create a document","href":"/api-reference/document/create-a-document"},{"openapi":"get /v1/doc/pdf/{doc_hash_id}","title":"Get document PDF","href":"/api-reference/document/get-document-pdf"},{"openapi":"delete /v1/doc/{doc_hash_id}","title":"Cancel a document","href":"/api-reference/document/cancel-a-document"}]},{"group":"Payment","pages":[{"openapi":"post /v1/payment","title":"Record payment","href":"/api-reference/payment/record-payment"}]},{"group":"Customer","pages":[{"openapi":"post /v1/customer","title":"Add a customer","href":"/api-reference/customer/add-a-customer"},{"openapi":"get /v1/customer/{customer_id}","title":"Get a customer","href":"/api-reference/customer/get-a-customer"},{"openapi":"put /v1/customer","title":"Update a customer","href":"/api-reference/customer/update-a-customer"},{"openapi":"delete /v1/customer/{customer_id}","title":"Delete a customer","href":"/api-reference/customer/delete-a-customer"},{"openapi":"get /v1/customer/ledger","title":"Get payment ledger","href":"/api-reference/customer/get-payment-ledger"},{"openapi":"get /v1/customer/list","title":"Get list of customers","href":"/api-reference/customer/get-list-of-customers"},{"openapi":"post /v1/customer/list","title":"Update customer mapping","href":"/api-reference/customer/update-customer-mapping"}]},{"group":"Product","pages":[{"openapi":"post /v1/product","title":"Add an item","href":"/api-reference/product/add-an-item"},{"openapi":"get /v1/product/{item_id}","title":"Get item details","href":"/api-reference/product/get-item-details"},{"openapi":"put /v1/product","title":"Update an item","href":"/api-reference/product/update-an-item"},{"openapi":"delete /v1/product/{item_id}","title":"Delete an item","href":"/api-reference/product/delete-an-item"},{"openapi":"get /v1/product/list","title":"Get list of items","description":"**v1 is deprecated — use the v2 endpoint instead.** Lists the items in your catalog.","href":"/api-reference/product/get-list-of-items"},{"openapi":"post /v1/product/list","title":"Update items mapping","href":"/api-reference/product/update-items-mapping"}]},{"group":"Subscriptions","pages":[{"openapi":"get /v1/subscriptions/list","title":"List of subscriptions","description":"**v1 is deprecated — use the v2 endpoint instead.** Lists subscriptions within a required date range, filterable by `status` and `customer_id`. Subscriptions are created through Create a document with `document_type=subscription`.","href":"/api-reference/subscriptions/list-of-subscriptions"},{"openapi":"get /v1/subscriptions/{subscription_hash_id}","title":"Get subscription details","href":"/api-reference/subscriptions/get-subscription-details"}]},{"group":"Utility","pages":[{"openapi":"get /v1/utils/gstin/{gstin}","title":"Get GSTIN details","href":"/api-reference/utility/get-gstin"}]},{"group":"EwayBill","pages":[{"openapi":"get /v2/ewaybill/pdf/{doc_hash_id}","title":"Get e-way bill PDF","href":"/api-reference/ewaybill/get-ewaybill-pdf"},{"openapi":"post /v2/ewaybill/{doc_hash_id}","title":"Create e-way bill","href":"/api-reference/ewaybill/create-eway-bill"}]}]}]}]},"title":"Update items mapping - Swipe","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}