Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass types to replace only some rule types and leave the rest untouched (e.g. sync your email list without disturbing industry rules); send an empty rules array with types to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Leadpipe Docs","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/leadpipecom/Z7juQCAiAHVYjTN3/logo/light.svg?fit=max\u0026auto=format\u0026n=Z7juQCAiAHVYjTN3\u0026q=85\u0026s=21eda734a1a0f9df6ab801958fe261d4","dark":"https://mintcdn.com/leadpipecom/Z7juQCAiAHVYjTN3/logo/dark.svg?fit=max\u0026auto=format\u0026n=Z7juQCAiAHVYjTN3\u0026q=85\u0026s=5a814e44098d41b1d02e650772845297"},"favicon":"https://mintcdn.com/leadpipecom/SPtnfhOaMQV1BmcZ/favicon.svg?fit=max\u0026auto=format\u0026n=SPtnfhOaMQV1BmcZ\u0026q=85\u0026s=486225fef351b77d6d30b0a59f15fbaa","search":{"prompt":"Search setup, visitor data, integrations, and APIs"},"seo":{"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"leadpipecom","hasAudioNarration":false,"actualSubdomain":"leadpipecom","customDomains":["docs.leadpipe.com"],"gitSource":{"type":"github","owner":"datasdk-ai","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa444aad8e4800762990a00","collectionId":"5f0a0352-93fe-47c4-965a-386418f816a0","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa444aad8e4800762990a00"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aa444aad8e4800762990a00","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Orbit API","count":58},{"language":"default","tag":"Guides","count":26},{"language":"default","tag":"Identification API","count":18},{"language":"default","tag":"Start here","count":10},{"language":"default","tag":"Workflow guides","count":9},{"language":"default","tag":"Destinations","count":9},{"language":"default","tag":"Audience results","count":9},{"language":"default","tag":"Visitor suppression","count":7},{"language":"default","tag":"Audience builder","count":7},{"language":"default","tag":"Evaluate and act on results","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/visitor-suppression/replace-the-suppression-list","slug":"/api-reference/visitor-suppression/replace-the-suppression-list","pageMetadata":{"title":"Replace the suppression list","description":"Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass `types` to replace only some rule types and leave the rest untouched (e.g. sync your `email` list without disturbing industry rules); send an empty `rules` array with `types` to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json put /v1/data/suppression-rules","href":"/api-reference/visitor-suppression/replace-the-suppression-list","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass \", _jsx(_components.code, {\n children: \"types\"\n }), \" to replace only some rule types and leave the rest untouched (e.g. sync your \", _jsx(_components.code, {\n children: \"email\"\n }), \" list without disturbing industry rules); send an empty \", _jsx(_components.code, {\n children: \"rules\"\n }), \" array with \", _jsx(_components.code, {\n children: \"types\"\n }), \" to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.\"]\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 the suppression list","description":"Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass `types` to replace only some rule types and leave the rest untouched (e.g. sync your `email` list without disturbing industry rules); send an empty `rules` array with `types` to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json put /v1/data/suppression-rules","href":"/api-reference/visitor-suppression/replace-the-suppression-list","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Visitor Suppression"],"summary":"Replace the suppression list","description":"Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass `types` to replace only some rule types and leave the rest untouched (e.g. sync your `email` list without disturbing industry rules); send an empty `rules` array with `types` to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.","security":["511b1a62-cfb9-4545-ac13-72e4786e6cad"],"requestBody":"a51a928a-2721-402d-b18d-059afafdf600","responses":{"200":"c03df4fc-8436-4edb-bfff-9319722f57ad","400":"fc7cc5fd-ac5b-4fc9-8c9f-801137f65339","401":"a112e595-de73-437b-ad11-ac2745823f35","403":"98a7ab45-7106-40ca-a270-b15c502b6f07"},"operationId":"replaceSuppressionList","method":"put","type":"path","servers":["bfd4637a-4961-4a5d-89f1-30ab58ae2cc9"],"path":"/v1/data/suppression-rules","baseUrlOptions":["https://api.aws53.cloud"],"title":"Replace the suppression list","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"rules":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["email","domain","company_domain","industry"],"isRequired":true,"uniqueKey":"rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","minLength":1,"maxLength":500,"isRequired":true,"uniqueKey":"rules.items.[INDEX].value","typeLabel":"string"}},"required":["type","value"],"uniqueKey":"rules.items.[INDEX]","typeLabel":"object"},"maxItems":25000,"isRequired":true,"uniqueKey":"rules","typeLabel":"object[]"},"types":{"type":"array","items":{"type":"string","enum":["email","domain","company_domain","industry"],"uniqueKey":"types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"minItems":1,"maxItems":4,"description":"Restrict the replace to these rule types. Rules of other types are left alone, and submitting a rule whose type is not listed is an error.","uniqueKey":"types","typeLabel":"enum\u003cstring>[]"}},"required":["rules"],"example":{"rules":[{"type":"domain","value":"company.test"},{"type":"domain","value":"subsidiary.test"}],"types":["domain"]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"rules":[{"type":"domain","value":"company.test"},{"type":"domain","value":"subsidiary.test"}],"types":["domain"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"c03df4fc-8436-4edb-bfff-9319722f57ad":{"description":"List replaced","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"added":{"type":"number","description":"Rules newly stored","isRequired":true,"uniqueKey":"data.added","typeLabel":"number"},"removed":{"type":"number","description":"Rules deleted (replace mode only)","isRequired":true,"uniqueKey":"data.removed","typeLabel":"number"},"duplicates":{"type":"number","description":"Rows skipped: already stored, or repeated within the request","isRequired":true,"uniqueKey":"data.duplicates","typeLabel":"number"},"rejectedCount":{"type":"number","description":"Rows that failed validation","isRequired":true,"uniqueKey":"data.rejectedCount","typeLabel":"number"},"rejected":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number","description":"Position of the row in the submitted array","isRequired":true,"uniqueKey":"data.rejected.items.[INDEX].index","typeLabel":"number"},"type":{"type":"string","isRequired":true,"uniqueKey":"data.rejected.items.[INDEX].type","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"data.rejected.items.[INDEX].value","typeLabel":"string"},"reason":{"type":"string","isRequired":true,"uniqueKey":"data.rejected.items.[INDEX].reason","typeLabel":"string"}},"required":["index","type","value","reason"],"uniqueKey":"data.rejected.items.[INDEX]","typeLabel":"object"},"description":"Detail for the first 100 rejected rows — everything else in the batch was still applied","isRequired":true,"uniqueKey":"data.rejected","typeLabel":"object[]"},"total":{"type":"number","description":"Rules stored for the organization after this call","isRequired":true,"uniqueKey":"data.total","typeLabel":"number"}},"required":["added","removed","duplicates","rejectedCount","rejected","total"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"example":{"data":{"added":1,"removed":2,"duplicates":0,"rejectedCount":0,"rejected":[],"total":1}},"examples":{"Example":{"title":"Example","value":{"data":{"added":1,"removed":2,"duplicates":0,"rejectedCount":0,"rejected":[],"total":1}}}},"exampleType":"examples"}},"exampleType":"examples"},"fc7cc5fd-ac5b-4fc9-8c9f-801137f65339":{"description":"Validation error","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a112e595-de73-437b-ad11-ac2745823f35":{"description":"Missing or invalid API key","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"98a7ab45-7106-40ca-a270-b15c502b6f07":{"description":"Revoked key or inactive organization","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"511b1a62-cfb9-4545-ac13-72e4786e6cad":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Organization API key (sk_...). Get yours from Settings > API Keys in the dashboard.","scopes":[]}}},"servers":{"bfd4637a-4961-4a5d-89f1-30ab58ae2cc9":{"url":"https://api.aws53.cloud","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Organization API key (sk_...). Get yours from Settings > API Keys in the dashboard.","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"Organization API key (sk_...). Get yours from Settings > API Keys in the dashboard.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"X-API-Key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"https://api.aws53.cloud/openapi-data.json"},"subdomain":"leadpipecom","siteName":"Leadpipe Docs","title":"Replace the suppression list - Leadpipe Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-11T18:13:59.466Z","originalFileLocation":"api-reference/visitor-suppression/replace-the-suppression-list.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=\"Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass types to replace only some rule types and leave the rest untouched (e.g. sync your email list without disturbing industry rules); send an empty rules array with types to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Leadpipe Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/leadpipecom/4tFSpvt9aWwHsjnO/_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/leadpipecom/4tFSpvt9aWwHsjnO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/leadpipecom/4tFSpvt9aWwHsjnO/_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/leadpipecom/4tFSpvt9aWwHsjnO/_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/leadpipecom/4tFSpvt9aWwHsjnO/_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/leadpipecom/4tFSpvt9aWwHsjnO/_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/leadpipecom/4tFSpvt9aWwHsjnO/_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/leadpipecom/4tFSpvt9aWwHsjnO/_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/leadpipecom/4tFSpvt9aWwHsjnO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Replace the suppression list - Leadpipe Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass types to replace only some rule types and leave the rest untouched (e.g. sync your email list without disturbing industry rules); send an empty rules array with types to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Leadpipe Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://leadpipecom.mintlify.app/_mintlify/api/og/v2?division=Visitor+suppression\u0026amp;title=Replace+the+suppression+list\u0026amp;description=Destructive+sync%3A+every+existing+rule+is+deleted+and+replaced+by+the+submitted+set%2C+in+one+transaction.+This+is+the+endpoint+to+point+at+a+source-of-truth+file+\u0026amp;theme=7668f3198002c139111191c1\u0026amp;signature=83333b2318ffb3d08068931a8c09aee84ae94a536b72cfc73e5f208939e673d7\">\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 the suppression list - Leadpipe Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass types to replace only some rule types and leave the rest untouched (e.g. sync your email list without disturbing industry rules); send an empty rules array with types to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://leadpipecom.mintlify.app/_mintlify/api/og/v2?division=Visitor+suppression\u0026amp;title=Replace+the+suppression+list\u0026amp;description=Destructive+sync%3A+every+existing+rule+is+deleted+and+replaced+by+the+submitted+set%2C+in+one+transaction.+This+is+the+endpoint+to+point+at+a+source-of-truth+file+\u0026amp;theme=7668f3198002c139111191c1\u0026amp;signature=83333b2318ffb3d08068931a8c09aee84ae94a536b72cfc73e5f208939e673d7\">\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/leadpipecom/4tFSpvt9aWwHsjnO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Leadpipe Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/visitor-suppression/replace-the-suppression-list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.leadpipe.com/#organization\",\"name\":\"Leadpipe Docs\",\"url\":\"https://docs.leadpipe.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/leadpipecom/Z7juQCAiAHVYjTN3/logo/light.svg?fit=max\u0026auto=format\u0026n=Z7juQCAiAHVYjTN3\u0026q=85\u0026s=21eda734a1a0f9df6ab801958fe261d4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.leadpipe.com#website\",\"name\":\"Leadpipe Docs\",\"url\":\"https://docs.leadpipe.com\",\"publisher\":{\"@id\":\"https://docs.leadpipe.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list#webpage\",\"url\":\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list\",\"name\":\"Replace the suppression list\",\"description\":\"Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass types to replace only some rule types and leave the rest untouched (e.g. sync your email list without disturbing industry rules); send an empty rules array with types to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.\",\"dateModified\":\"2026-09-11T18:13:59.466Z\",\"isPartOf\":{\"@id\":\"https://docs.leadpipe.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Visitor suppression\",\"item\":\"https://docs.leadpipe.com/api-reference/visitor-suppression\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Replace the suppression list\",\"item\":\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list#apireference\",\"headline\":\"Replace the suppression list\",\"name\":\"Replace the suppression list\",\"description\":\"Destructive sync: every existing rule is deleted and replaced by the submitted set, in one transaction. This is the endpoint to point at a source-of-truth file — re-post the whole list on every run and the stored list matches it exactly. Rules removed here stop suppressing from the next sync cycle onward. Pass types to replace only some rule types and leave the rest untouched (e.g. sync your email list without disturbing industry rules); send an empty rules array with types to clear a category. Up to 25,000 rules per call — a list longer than that cannot be replaced atomically, so build it with POST instead. Authenticates via X-API-Key header.\",\"url\":\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.leadpipe.com/api-reference/visitor-suppression/replace-the-suppression-list#webpage\"},\"dateModified\":\"2026-09-11T18:13:59.466Z\",\"publisher\":{\"@id\":\"https://docs.leadpipe.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.leadpipe.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Leadpipe Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Leadpipe Docs","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Identification API","groups":[{"group":"Start here","pages":[{"title":"Identification API overview","href":"/api-reference/introduction"},{"title":"Make your first API request","href":"/api-reference/quickstart"},{"title":"Authentication and errors","href":"/api-reference/authentication-and-errors"}]},{"group":"Visitors","pages":[{"title":"Retrieve visitor data","href":"/api-reference/data-api"},{"title":"Query visitor data via API key","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json get /v1/data","href":"/api-reference/visitors/query-visitor-data-via-api-key"},{"title":"List privacy-bounded session summaries","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json get /v1/data/visitors/{visitorId}/sessions","href":"/api-reference/visitors/list-privacy-bounded-session-summaries"},{"title":"Query qualified visitor data via API key","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json post /v1/data/query","href":"/api-reference/visitors/query-qualified-visitor-data-via-api-key"}]},{"group":"Pixels","pages":[{"title":"Create a pixel for a domain","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json post /v1/data/pixels","href":"/api-reference/pixels/create-a-pixel-for-a-domain"},{"title":"List all pixels for the organization","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json get /v1/data/pixels","href":"/api-reference/pixels/list-all-pixels-for-the-organization"},{"title":"Update a pixel (pause, activate, or set path filters)","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json patch /v1/data/pixels/{id}","href":"/api-reference/pixels/update-a-pixel-pause-activate-or-set-path-filters"}]},{"group":"Visitor suppression","pages":[{"title":"Visitor suppression","href":"/api-reference/visitor-suppression"},{"title":"List suppression rules","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json get /v1/data/suppression-rules","href":"/api-reference/visitor-suppression/list-suppression-rules"},{"title":"Upload suppression rules (append)","description":"Adds up to 25,000 rules in one call, on top of what is already stored; send more by posting again. There is no cap on how many rules an organization may keep. Values are normalized before storage (lowercased; domains lose scheme, `www.`, path and port), so re-uploading the same list is a no-op. Rows that fail validation come back in `rejected` — every other row is still applied. Rules take effect from the next sync cycle onward; visitors already charged are not refunded. Authenticates via X-API-Key header.","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json post /v1/data/suppression-rules","href":"/api-reference/visitor-suppression/upload-suppression-rules-append"},{"title":"Replace the suppression list","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json put /v1/data/suppression-rules","href":"/api-reference/visitor-suppression/replace-the-suppression-list"},{"title":"Delete suppression rules in bulk","description":"Deletes by rule id, by type+value, or both. Values are normalized the same way as on upload, so you can delete with the exact rows you uploaded without tracking ids. Unknown ids and values are ignored. Authenticates via X-API-Key header.","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json delete /v1/data/suppression-rules","href":"/api-reference/visitor-suppression/delete-suppression-rules-in-bulk"},{"title":"List industries present in your visitor data","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json get /v1/data/suppression-rules/industries","href":"/api-reference/visitor-suppression/list-industries-present-in-your-visitor-data"},{"title":"Delete a single suppression rule","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json delete /v1/data/suppression-rules/{ruleId}","href":"/api-reference/visitor-suppression/delete-a-single-suppression-rule"}]},{"group":"Account status","pages":[{"title":"Account health and credit status","deprecated":null,"version":null,"openapi":"https://api.aws53.cloud/openapi-data.json get /v1/data/account","href":"/api-reference/account/account-health-and-credit-status"}]}]},{"tab":"Orbit API","pages":[{"title":"Orbit API","href":"/orbit-api/introduction"}]},{"tab":"IP to company API","pages":[{"title":"IP to company API","href":"/ip-to-company/introduction"}]}]},"basePath":"","title":"Replace the suppression list - Leadpipe Docs","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}