{
"message": "Invalid tag IDs: invalid-tag-1, invalid-tag-2"
}
{
"message": "Forbidden"
}
{
"message": "Lead not found"
}
{
"message": "Internal Server Error"
}
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Apten","colors":{"primary":"#2563eb","light":"#2563eb","dark":"#2563eb"},"logo":{"light":"https://mintcdn.com/apten/YWMBZJCBaobOmPBP/logo/logo_light.png?fit=max\u0026auto=format\u0026n=YWMBZJCBaobOmPBP\u0026q=85\u0026s=6a579d72aa1a2d000033e5f3163e94ef","dark":"https://mintcdn.com/apten/YWMBZJCBaobOmPBP/logo/logo_dark.png?fit=max\u0026auto=format\u0026n=YWMBZJCBaobOmPBP\u0026q=85\u0026s=c964a0c21134fb91b7200c7084d1970c"},"favicon":"https://mintcdn.com/apten/YWMBZJCBaobOmPBP/favicon.png?fit=max\u0026auto=format\u0026n=YWMBZJCBaobOmPBP\u0026q=85\u0026s=fc69506e3b831e993d871d58458b1891","api":{"openapi":"api-reference/openapi.yaml"},"navbar":{"links":[{"href":"mailto:founders@apten.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://platform.attent.app/"}},"footer":{"socials":{"x":"https://x.com/Apten_AI","linkedin":"https://www.linkedin.com/company/apten"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apten","hasAudioNarration":false,"actualSubdomain":"apten","customDomains":["docs.apten.ai"],"gitSource":{"type":"github","owner":"apten-ai","repo":"apten-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af557d497386d2c83f35101","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Documentation","count":63},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Webhooks","count":27},{"language":"default","tag":"Changelog","count":23},{"language":"default","tag":"Updates","count":23},{"language":"default","tag":"Leads","count":18},{"language":"default","tag":"Lead Webhook Events","count":17},{"language":"default","tag":"Tutorials","count":15},{"language":"default","tag":"AI Helpers","count":13},{"language":"default","tag":"Webchat Webhook Events","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"tux.css","content":".tux-film{margin:1.75rem 0;overflow:hidden;border:1px solid rgba(37, 99, 235, 0.2);border-radius:1rem;background:#f8faff;box-shadow:0 12px 36px -20px rgba(37, 99, 235, 0.35)}.tux-film-video{display:block;width:100%;height:auto;aspect-ratio:16 / 9;margin:0;background:#f8faff}.tux-film-video:focus-visible{outline:3px solid #2563eb;outline-offset:-3px}.dark .tux-film{border-color:rgba(96, 165, 250, 0.3);box-shadow:none}.tux-film-video::-webkit-media-controls-mute-button,.tux-film-video::-webkit-media-controls-volume-slider,.tux-film-video::-webkit-media-controls-volume-control-container,.tux-film-video::-webkit-media-controls-volume-control-hover-background{display:none!important}.tux-launcher-shot{display:block;width:69px;height:82px;margin:1rem 0}.tux-shot{position:relative;overflow:hidden;margin:1.5rem 0;border:1px solid #e2e8f0;border-radius:0.75rem;background:#fff}.tux-shot img{display:block;width:100%;height:auto;margin:0;border-radius:0}.tux-shot-create{aspect-ratio:2358 / 302}.tux-shot-preview{width:100%;max-width:360px;aspect-ratio:734 / 1018}.tux-shot-preview img{position:absolute;top:-9.823%;left:0}.tux-shot-dashboard{aspect-ratio:2352 / 1026}.tux-shot-card{max-width:520px}.tux-shot-export{max-width:520px;aspect-ratio:694 / 300}.tux-shot-export img{position:absolute;top:-125%;left:0}.tux-shot-download{aspect-ratio:1084 / 150}.tux-shot-download img{position:absolute;width:105.535%;max-width:none;top:-760%;left:-5.535%}.dark .tux-shot{border-color:#334155}"},{"filePath":"flow-studio.css","content":".flow-studio-controls{display:flex;flex-wrap:wrap;align-items:center;gap:0.75rem;margin:1rem 0}.flow-studio-control{display:block;width:auto;max-width:100%;height:40px;margin:0;border-radius:0.5rem}.flow-studio-tests-control{height:55px}.flow-studio-panel-shot{max-width:420px;aspect-ratio:940 / 1176}.flow-studio-panel-shot img{position:absolute;top:-32.653%;left:0}.flow-studio-history-shot{max-width:520px;aspect-ratio:940 / 102}.tux-shot.flow-studio-panel-shot,.tux-shot.flow-studio-history-shot,.tux-shot.flow-studio-test-actions-shot,.tux-shot.flow-studio-editor-shot{overflow:clip}.flow-studio-history-shot img{position:absolute;top:0;left:0}.flow-studio-test-actions-shot{max-width:230px;aspect-ratio:460 / 100}.tux-shot.flow-studio-test-actions-shot img{position:absolute;width:341.304%;max-width:none;top:-40%;left:-234.783%}.flow-studio-editor-shot img{position:absolute;max-width:none}.flow-studio-test-templates-shot{aspect-ratio:1274 / 612}.tux-shot.flow-studio-test-templates-shot img{width:104.553%;top:-36.275%;left:-2.983%}.flow-studio-test-scenario-shot{aspect-ratio:1280 / 632}.tux-shot.flow-studio-test-scenario-shot img{width:105.625%;top:-6.962%;left:-3.125%}.flow-studio-test-assertions-shot{aspect-ratio:1280 / 770}.tux-shot.flow-studio-test-assertions-shot img{width:107.188%;top:-8.831%;left:-4.375%}"}],"page":{"pagePath":"api-reference/leads/replace-tags","slug":"/api-reference/leads/replace-tags","pageMetadata":{"title":"Replace tags","openapi":"put /leads/{leadId}/tags","description":"Replace all tags on a lead","href":"/api-reference/leads/replace-tags"},"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: \"Replace all tags on a lead\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Replace tags","openapi":"put /leads/{leadId}/tags","description":"Replace all tags on a lead","href":"/api-reference/leads/replace-tags"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Replace all tags on a lead","parameters":["14d82235-60b1-43cb-b353-6128d0ef5ac0"],"requestBody":"9cda82a8-3a39-4634-8c38-360780c9aef5","responses":{"200":"f7df3759-265f-42ea-a0da-5635eda49404","400":"4c25b929-9446-497e-b189-7c5548af70f0","403":"0208fcfe-1065-4822-ad57-981e1df1dfb9","404":"2f48b4cf-6aea-4bfb-940d-6800462b23fd","500":"4a26aa30-b5c5-4327-b208-98e43e36bc91"},"security":["0ebca92b-11b8-438c-af7f-091a6f098864"],"method":"put","type":"path","servers":["8684890a-5a9a-4907-a0c2-eb544ca8d1c1"],"path":"/leads/{leadId}/tags","baseUrlOptions":["https://api.attent.app/v1"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"14d82235-60b1-43cb-b353-6128d0ef5ac0":{"name":"leadId","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The ID of the lead to update tags for","uniqueKey":"","typeLabel":"string"},"description":"The ID of the lead to update tags for"}},"requestBody":{"description":"Array of tag IDs to set on the lead","content":{"application/json":{"schema":{"type":"object","required":["tagIds"],"properties":{"tagIds":{"type":"array","items":{"type":"string","uniqueKey":"tagIds.items.[INDEX]","typeLabel":"string"},"description":"Array of tag IDs to replace existing tags with","isRequired":true,"uniqueKey":"tagIds","typeLabel":"string[]"}},"example":{"tagIds":["tag1","tag2","tag3"]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"tagIds":["tag1","tag2","tag3"]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"f7df3759-265f-42ea-a0da-5635eda49404":{"description":"Tags successfully replaced.","content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the tag","uniqueKey":"tags.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"The name of the tag","uniqueKey":"tags.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"tags.items.[INDEX]","typeLabel":"object"},"description":"Array of tags now assigned to the lead","uniqueKey":"tags","typeLabel":"object[]"}},"example":{"tags":[{"id":"tag1","name":"VIP Customer"},{"id":"tag2","name":"Interested"},{"id":"tag3","name":"Follow Up Required"}]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"tags":[{"id":"tag1","name":"VIP Customer"},{"id":"tag2","name":"Interested"},{"id":"tag3","name":"Follow Up Required"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"4c25b929-9446-497e-b189-7c5548af70f0":{"description":"Bad request - invalid tag IDs provided","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"example":{"message":"Invalid tag IDs: invalid-tag-1, invalid-tag-2"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Invalid tag IDs: invalid-tag-1, invalid-tag-2"}}},"exampleType":"generated"}},"exampleType":"generated"},"0208fcfe-1065-4822-ad57-981e1df1dfb9":{"description":"Forbidden API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"example":{"message":"Forbidden"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Forbidden"}}},"exampleType":"generated"}},"exampleType":"generated"},"2f48b4cf-6aea-4bfb-940d-6800462b23fd":{"description":"Lead not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"example":{"message":"Lead not found"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Lead not found"}}},"exampleType":"generated"}},"exampleType":"generated"},"4a26aa30-b5c5-4327-b208-98e43e36bc91":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"example":{"message":"Internal Server Error"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Internal Server Error"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0ebca92b-11b8-438c-af7f-091a6f098864":{"api_key":{"type":"apiKey","name":"x-api-key","in":"header","scopes":[],"schemeName":"api_key"}}},"servers":{"8684890a-5a9a-4907-a0c2-eb544ca8d1c1":{"url":"https://api.attent.app/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","name":"x-api-key","in":"header","scopes":[],"schemeName":"api_key"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"api_key","name":"x-api-key"}],"title":"api_key"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"apten","siteName":"Apten","title":"Replace tags - Apten","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-26T21:23:21.852Z","originalFileLocation":"api-reference/leads/replace-tags.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=\"Replace all tags on a lead\">\u003cmeta data-mint-head name=\"application-name\" content=\"Apten\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apten/VDEJsPp6LdIQyuJC/_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/apten/VDEJsPp6LdIQyuJC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apten/VDEJsPp6LdIQyuJC/_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/apten/VDEJsPp6LdIQyuJC/_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/apten/VDEJsPp6LdIQyuJC/_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/apten/VDEJsPp6LdIQyuJC/_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/apten/VDEJsPp6LdIQyuJC/_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/apten/VDEJsPp6LdIQyuJC/_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/apten/VDEJsPp6LdIQyuJC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Replace tags - Apten\">\u003cmeta data-mint-head property=\"og:description\" content=\"Replace all tags on a lead\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Apten\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apten.ai/api-reference/leads/replace-tags\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apten.mintlify.site/_mintlify/api/og/v2?division=Leads\u0026amp;title=Replace+tags\u0026amp;description=Replace+all+tags+on+a+lead\u0026amp;theme=823acdaac487aa39f94d73e6\u0026amp;signature=e656e4c726854abb66a03b9c1493127f64ee312b0b457ff76ab54901777a8ec8\">\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=\"Replace tags - Apten\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Replace all tags on a lead\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apten.mintlify.site/_mintlify/api/og/v2?division=Leads\u0026amp;title=Replace+tags\u0026amp;description=Replace+all+tags+on+a+lead\u0026amp;theme=823acdaac487aa39f94d73e6\u0026amp;signature=e656e4c726854abb66a03b9c1493127f64ee312b0b457ff76ab54901777a8ec8\">\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/apten/VDEJsPp6LdIQyuJC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Apten\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apten.ai/api-reference/leads/replace-tags\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/leads/replace-tags.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apten.ai/#organization\",\"name\":\"Apten\",\"url\":\"https://docs.apten.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/apten/YWMBZJCBaobOmPBP/logo/logo_light.png?fit=max\u0026auto=format\u0026n=YWMBZJCBaobOmPBP\u0026q=85\u0026s=6a579d72aa1a2d000033e5f3163e94ef\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apten.ai#website\",\"name\":\"Apten\",\"url\":\"https://docs.apten.ai\",\"publisher\":{\"@id\":\"https://docs.apten.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apten.ai/api-reference/leads/replace-tags#webpage\",\"url\":\"https://docs.apten.ai/api-reference/leads/replace-tags\",\"name\":\"Replace tags\",\"description\":\"Replace all tags on a lead\",\"dateModified\":\"2026-08-26T21:23:21.852Z\",\"isPartOf\":{\"@id\":\"https://docs.apten.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apten.ai/api-reference/leads/replace-tags#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apten.ai/api-reference/leads/replace-tags#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Leads\",\"item\":\"https://docs.apten.ai/api-reference/leads/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Replace tags\",\"item\":\"https://docs.apten.ai/api-reference/leads/replace-tags\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.apten.ai/api-reference/leads/replace-tags#apireference\",\"headline\":\"Replace tags\",\"name\":\"Replace tags\",\"description\":\"Replace all tags on a lead\",\"url\":\"https://docs.apten.ai/api-reference/leads/replace-tags\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apten.ai/api-reference/leads/replace-tags#webpage\"},\"dateModified\":\"2026-08-26T21:23:21.852Z\",\"publisher\":{\"@id\":\"https://docs.apten.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apten.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Apten\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Apten\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/leads/replace-tags.md","siteName":"Apten","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"AI Helpers","pages":[{"title":"AI Helpers","href":"/tux/overview"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Leads","pages":[{"title":"Create a lead","openapi":"post /leads/create","href":"/api-reference/leads/create"},{"title":"List leads","openapi":"get /leads","href":"/api-reference/leads/list"},{"title":"Get lead","openapi":"get /leads/{leadId}","href":"/api-reference/leads/get-lead"},{"title":"Update lead","openapi":"patch /leads/{leadId}","href":"/api-reference/leads/update"},{"title":"Delete a lead","openapi":"delete /leads/{leadId}","href":"/api-reference/leads/delete"},{"title":"Get messages","openapi":"get /leads/{leadId}/messages","href":"/api-reference/leads/get-messages"},{"title":"List events for a lead","openapi":"get /leads/{leadId}/events","href":"/api-reference/leads/list-events"},{"title":"Turn off a lead","openapi":"post /leads/{leadId}/turnOff","href":"/api-reference/leads/turn-off"},{"title":"Turn on a lead","openapi":"post /leads/{leadId}/turnOn","href":"/api-reference/leads/turn-on"},{"title":"Add context to a lead","openapi":"post /leads/{leadId}/addContext","href":"/api-reference/leads/add-context"},{"title":"Switch lead's customer profile","openapi":"post /leads/{leadId}/switchCustomerProfile","href":"/api-reference/leads/switch-customer-profile"},{"title":"Look up lead by phone","openapi":"get /leads/lookup","href":"/api-reference/leads/lookup"},{"title":"Send message to a lead","openapi":"post /leads/{leadId}/sendMessage","href":"/api-reference/leads/send-message"},{"title":"Unsubscribe a lead","openapi":"post /leads/{leadId}/unsubscribe","href":"/api-reference/leads/unsubscribe"},{"title":"Resubscribe a lead","openapi":"post /leads/{leadId}/resubscribe","description":"Resubscribes a lead to one or more channels (SMS, voice, email) they previously unsubscribed from. Also clears the lead's do-not-contact status, and removes the phone number from the Do Not Contact (DNC) list when SMS is resubscribed. Does not change whether Apten is on for the lead.","href":"/api-reference/leads/resubscribe"},{"title":"Replace tags","openapi":"put /leads/{leadId}/tags","href":"/api-reference/leads/replace-tags"},{"title":"Add tags","openapi":"post /leads/{leadId}/tags","description":"Add tags to a lead (will not remove existing tags)","href":"/api-reference/leads/add-tags"},{"title":"Remove tags","openapi":"post /leads/{leadId}/tags/remove","href":"/api-reference/leads/remove-tags"}]},{"group":"Calls","pages":[{"title":"Get call","openapi":"get /calls/{callId}","href":"/api-reference/calls/get-call"},{"title":"Get recording","openapi":"get /calls/{callId}/recording","href":"/api-reference/calls/get-recording"}]},{"group":"Webchat","pages":[{"title":"Disable webchat auto-conversion","openapi":"post /webchat/sessions/{sessionId}/disableAutoConversion","href":"/api-reference/webchat/disable-auto-conversion"}]},{"group":"Tags","pages":[{"title":"Get tags","openapi":"get /tags","href":"/api-reference/tags/get-tags"}]},{"group":"Usage","pages":[{"title":"Get usage","openapi":"get /usage","href":"/api-reference/usage/get-usage"}]},{"group":"Do Not Contact","pages":[{"title":"Add to DNC List","openapi":"post /dnc/register","href":"/api-reference/dnc/register"},{"title":"List DNC Numbers","openapi":"get /dnc","href":"/api-reference/dnc/list-dnc"},{"title":"Check DNC Status","openapi":"get /dnc/{phone_number}","href":"/api-reference/dnc/get-dnc"},{"title":"Remove from DNC List","openapi":"delete /dnc/{phone_number}","href":"/api-reference/dnc/delete-dnc"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026-11"}]}]},"basePath":"","title":"Replace tags - Apten","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C4GwDT3_.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}