{
"success": true,
"message": "Message",
"error_code": "",
"errors": {},
"data": {
"message": "No data found!"
}
}
Products
Update items mapping
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-v2/update-items-mapping","slug":"/api-reference/product-v2/update-items-mapping","pageMetadata":{"openapi":"post /v2/product/list","title":"Update items mapping","description":"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-v2/update-items-mapping"},"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: \"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 /v2/product/list","title":"Update items mapping","description":"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-v2/update-items-mapping"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Update items mapping","operationId":"post_item_list","tags":["Product V2"],"requestBody":"0c923a65-ef3d-4ca9-9abc-1732d9af2154","responses":{"200":"bba1ed19-1fa5-43bb-8a76-1956f3d6f9ad","400":"28a65f2b-b49d-4ee6-9bc6-c23e9ee33c32","401":"10dac978-96d5-479d-9b85-6c7fa13e168a","409":"a0af575e-83d2-4e63-beae-9b3ad8496c6b","500":"31b7f8e8-a4c5-403a-8608-693a5f275c34"},"description":"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":"/v2/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":{"bba1ed19-1fa5-43bb-8a76-1956f3d6f9ad":{"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":"Message","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"properties":{"message":{"type":"string","description":"Response message","example":"No data found!","uniqueKey":"data.message","typeLabel":"string"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Message","error_code":"","errors":{},"data":{"message":"No data found!"}}}},"exampleType":"generated"}},"exampleType":"generated"},"28a65f2b-b49d-4ee6-9bc6-c23e9ee33c32":{"description":"Error in mapping Item List","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"Message","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"properties":{"message":{"type":"string","description":"Response message","example":"No data found!","uniqueKey":"data.message","typeLabel":"string"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Message","error_code":"","errors":{},"data":{"message":"No data found!"}}}},"exampleType":"generated"}},"exampleType":"generated"},"10dac978-96d5-479d-9b85-6c7fa13e168a":{"description":"Unauthorized","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"Message","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"properties":{"message":{"type":"string","description":"Response message","example":"No data found!","uniqueKey":"data.message","typeLabel":"string"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Message","error_code":"","errors":{},"data":{"message":"No data found!"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a0af575e-83d2-4e63-beae-9b3ad8496c6b":{"description":"Error in mapping Item List","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"Message","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"type":"object","description":"Data","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Message","error_code":"","errors":{},"data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"31b7f8e8-a4c5-403a-8608-693a5f275c34":{"description":"Internal Server Error","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean","description":"Success flag","example":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","example":"Message","uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","description":"Error Code","example":"","uniqueKey":"error_code","typeLabel":"string"},"errors":{"type":"object","description":"Errors","uniqueKey":"errors","typeLabel":"object"},"data":{"properties":{"message":{"type":"string","description":"Response message","example":"No data found!","uniqueKey":"data.message","typeLabel":"string"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Message","error_code":"","errors":{},"data":{"message":"No data found!"}}}},"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":0},"v1 (Deprecated)":{"href":"/api-reference/product/update-items-mapping","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T07:51:51.982Z","originalFileLocation":"api-reference/product-v2/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=\"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=\"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-v2/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=Products\u0026amp;title=Update+items+mapping\u0026amp;description=Re-links+your+item+IDs+to+existing+Swipe+records+in+bulk.+Use+this+after+changing+IDs+in+your+own+system%2C+so+future+calls+don%27t+create+duplicate+items.\u0026amp;theme=6f6d44835af80bcfb7f23dbb\u0026amp;signature=8ad3b38a417b78809a7c532012126fdf7f49dffbefd63f867939117265c3f19f\">\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=\"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=Products\u0026amp;title=Update+items+mapping\u0026amp;description=Re-links+your+item+IDs+to+existing+Swipe+records+in+bulk.+Use+this+after+changing+IDs+in+your+own+system%2C+so+future+calls+don%27t+create+duplicate+items.\u0026amp;theme=6f6d44835af80bcfb7f23dbb\u0026amp;signature=8ad3b38a417b78809a7c532012126fdf7f49dffbefd63f867939117265c3f19f\">\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-v2/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-v2/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-v2/update-items-mapping#webpage\",\"url\":\"https://developers.getswipe.in/api-reference/product-v2/update-items-mapping\",\"name\":\"Update items mapping\",\"description\":\"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.982Z\",\"isPartOf\":{\"@id\":\"https://developers.getswipe.in#website\"},\"breadcrumb\":{\"@id\":\"https://developers.getswipe.in/api-reference/product-v2/update-items-mapping#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.getswipe.in/api-reference/product-v2/update-items-mapping#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Products\",\"item\":\"https://developers.getswipe.in/api-reference/product-v2/add-an-item\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update items mapping\",\"item\":\"https://developers.getswipe.in/api-reference/product-v2/update-items-mapping\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.getswipe.in/api-reference/product-v2/update-items-mapping#apireference\",\"headline\":\"Update items mapping\",\"name\":\"Update items mapping\",\"description\":\"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-v2/update-items-mapping\",\"mainEntityOfPage\":{\"@id\":\"https://developers.getswipe.in/api-reference/product-v2/update-items-mapping#webpage\"},\"dateModified\":\"2026-08-27T07:51:51.982Z\",\"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","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":"Documents","pages":[{"openapi":"post /v2/doc","title":"Create a document","href":"/api-reference/document-v2/create-a-document"},{"openapi":"get /v2/doc/{doc_hash_id}","title":"Get a document","href":"/api-reference/document-v2/get-a-document"},{"openapi":"get /v2/doc/pdf/{doc_hash_id}","title":"Get document PDF","href":"/api-reference/document-v2/get-document-pdf"},{"openapi":"put /v2/doc/{doc_hash_id}","title":"Edit a document","href":"/api-reference/document-v2/edit-a-document"},{"openapi":"delete /v2/doc/{doc_hash_id}","title":"Cancel a document","href":"/api-reference/document-v2/cancel-a-document"},{"openapi":"get /v2/doc/list","title":"List of documents","href":"/api-reference/document-v2/list-of-documents"}]},{"group":"Payments","pages":[{"openapi":"post /v2/payment","title":"Record payment","href":"/api-reference/payment-v2/record-payment"},{"openapi":"get /v2/payment/list","title":"List of payments","href":"/api-reference/payment-v2/list-of-payments"}]},{"group":"E-Way Bills","pages":[{"openapi":"post /v2/ewaybill/{doc_hash_id}","title":"Create e-way bill","href":"/api-reference/ewaybill/create-eway-bill"},{"openapi":"get /v2/ewaybill/pdf/{doc_hash_id}","title":"Get e-way bill PDF","href":"/api-reference/ewaybill/get-ewaybill-pdf"}]},{"group":"Customers","pages":[{"openapi":"post /v2/customer","title":"Add a customer","href":"/api-reference/customer-v2/add-a-customer"},{"openapi":"get /v2/customer/{customer_id}","title":"Get customer details","href":"/api-reference/customer-v2/get-customer-details"},{"openapi":"put /v2/customer","title":"Update a customer","href":"/api-reference/customer-v2/update-a-customer"},{"openapi":"delete /v2/customer/{customer_id}","title":"Delete a customer","href":"/api-reference/customer-v2/delete-a-customer"},{"openapi":"get /v2/customer/ledger","title":"Get payment ledger","href":"/api-reference/customer-v2/get-payment-ledger"},{"openapi":"get /v2/customer/list","title":"Get list of customers","href":"/api-reference/customer-v2/get-list-of-customers"},{"openapi":"post /v2/customer/list","title":"Update customer mapping","href":"/api-reference/customer-v2/update-customer-mapping"}]},{"group":"Vendors","pages":[{"openapi":"post /v2/vendor","title":"Add a vendor","href":"/api-reference/vendor-v2/add-a-vendor"},{"openapi":"get /v2/vendor/{vendor_id}","title":"Get vendor details","href":"/api-reference/vendor-v2/get-vendor-details"},{"openapi":"put /v2/vendor","title":"Update a vendor","href":"/api-reference/vendor-v2/update-a-vendor"},{"openapi":"delete /v2/vendor/{vendor_id}","title":"Delete a vendor","href":"/api-reference/vendor-v2/delete-a-vendor"},{"openapi":"get /v2/vendor/ledger","title":"Get payment ledger","href":"/api-reference/vendor-v2/get-payment-ledger"},{"openapi":"get /v2/vendor/list","title":"Get list of vendors","href":"/api-reference/vendor-v2/get-list-of-vendors"},{"openapi":"post /v2/vendor/list","title":"Update vendor mapping","href":"/api-reference/vendor-v2/update-vendor-mapping"}]},{"group":"Products","pages":[{"openapi":"post /v2/product","title":"Add an item","href":"/api-reference/product-v2/add-an-item"},{"openapi":"get /v2/product/{item_id}","title":"Get item details","href":"/api-reference/product-v2/get-item-details"},{"openapi":"put /v2/product","title":"Update an item","href":"/api-reference/product-v2/update-an-item"},{"openapi":"delete /v2/product/{item_id}","title":"Delete an item","href":"/api-reference/product-v2/delete-an-item"},{"openapi":"get /v2/product/list","title":"Get list of items","description":"Lists the items in your catalog.","href":"/api-reference/product-v2/get-list-of-items"},{"openapi":"post /v2/product/list","title":"Update items mapping","href":"/api-reference/product-v2/update-items-mapping"}]},{"group":"Inventory","pages":[{"openapi":"post /v2/inventory/stock","title":"Update inventory stock","description":"Records a manual stock movement for a product — `in` adds stock, `out` removes it. Use `warehouse_id` -1 for the default warehouse and `record_date` to backdate the movement. Sales and purchase documents also move stock automatically.","href":"/api-reference/inventory-v2/inventory-stock-in-out"},{"openapi":"get /v2/inventory/warehouses/list","title":"Get all warehouses","href":"/api-reference/inventory-v2/get-all-warehouses"}]},{"group":"Subscriptions","pages":[{"openapi":"get /v2/subscriptions/list","title":"List of subscriptions","href":"/api-reference/subscriptions-v2/list-of-subscriptions"},{"openapi":"get /v2/subscriptions/{subscription_hash_id}","title":"Get subscription details","href":"/api-reference/subscriptions-v2/get-subscription-details"}]},{"group":"Utility","pages":[{"openapi":"get /v2/utils/gstin/{gstin}","title":"Get GSTIN details","href":"/api-reference/utility-v2/get-gstin-v2"}]}]}]},{"version":"v1 (Deprecated)","pages":[{"title":"v1 (Deprecated)","href":"/api-reference/product/update-items-mapping"}]}]},"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"]}