{
"errors": [
{
"code": "VersionMismatch",
"message": "This detection was changed since the version you supplied. Re-read the exemptions and retry."
}
]
}
{
"message": "Internal server error"
}
Replace a detection's exemptions
Replace the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID.
Send the version from the read as If-Match. The write is then rejected with a 412 (VersionMismatch) if the detection’s configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no 412 is returned. Send it whenever the read returned a version, and omit it only when version was null, since there is then no stored configuration to match against.
version covers the detection’s whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile.
A non-empty set is rejected with a 400 when the detection does not accept exemptions (ExemptionsNotSupported) or when an entry’s type is outside the detection’s supportedExemptionTypes (UnsupportedExemptionType). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today.
Only the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.
{
"errors": [
{
"code": "VersionMismatch",
"message": "This detection was changed since the version you supplied. Re-read the exemptions and retry."
}
]
}
{
"message": "Internal server error"
}
Authorizations
Authorization
string
header
required
Bearer API Key. For example, "Bearer {Tenant API Key}"
Headers
Authorization
string
required
Bearer API Key. For example, "Bearer {Tenant API Key}"
Content-Type
string
application/json
If-Match
string
The version returned by the read, echoed back unchanged. When supplied, the write is rejected with a 412 unless it still matches the stored value. When omitted, the write applies unconditionally. Omit it only when the detection has no stored configuration on the profile yet.
Path Parameters
profileId
string
required
Profile ID, or the literal string default for the tenant's default profile. default covers only the integrations that have not been given a profile of their own, so on a tenant with more than one profile it does not reach the rest. Use List profiles to get the IDs.
Example:
"default"
detectionId
string
required
Detection ID. A finding reports the detection that produced it in its detectionId field.
Example:
"PLERION-AWS-16"
Body
application/json
exemptions
object[]
required
The complete exemption set for the detection. Send an empty array to clear it.
One exemption rule to write. The type decides which other fields apply, and which types a detection accepts is reported by supportedExemptionTypes on the read. The read returns StoredDetectionExemption, which is looser.
Option 1
Option 2
Option 3
Option 4
Option 5
Show child attributes
Response
Exemptions replaced
data
object
The exemptions configured for one detection on one profile.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Plerion, Simplify Cloud Security - documentation","description":"Plerion, Simplify Cloud Security - documentation","colors":{"primary":"#FFA500","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/pleriondocs/GIwfwlVd5Zt2w0-r/logo/plerion.svg?fit=max\u0026auto=format\u0026n=GIwfwlVd5Zt2w0-r\u0026q=85\u0026s=86e89d26c3b52a61495baaf98faff52c","dark":"https://mintcdn.com/pleriondocs/GIwfwlVd5Zt2w0-r/logo/plerion.svg?fit=max\u0026auto=format\u0026n=GIwfwlVd5Zt2w0-r\u0026q=85\u0026s=86e89d26c3b52a61495baaf98faff52c"},"favicon":"https://mintcdn.com/pleriondocs/tawzAAKnRc9yNNhT/favicon.svg?fit=max\u0026auto=format\u0026n=tawzAAKnRc9yNNhT\u0026q=85\u0026s=43160b812d8a7d732e3a72cf166dbbec","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.plerion.com/sign-in"}},"footer":{"socials":{"x":"https://x.com/plerionhq","linkedin":"https://www.linkedin.com/company/plerion"},"links":[{"header":"Company","items":[{"label":"Plerion","href":"https://www.plerion.com"},{"label":"Contact","href":"https://www.plerion.com/company/contact-us"},{"label":"Partnerships","href":"https://www.plerion.com/company/partnerships"}]},{"header":"Resources","items":[{"label":"Blog","href":"https://www.plerion.com/blog"},{"label":"Trust center","href":"https://trust.plerion.com/"},{"label":"Privacy policy","href":"https://www.plerion.com/company/privacy-policy"}]}]},"search":{"prompt":"Search the docs"},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pleriondocs","hasAudioNarration":false,"actualSubdomain":"pleriondocs","customDomains":["docs.plerion.com"],"gitSource":{"type":"github","owner":"plerionhq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afdffa95f872098837a0816","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API reference","count":124},{"language":"default","tag":"Guides","count":124},{"language":"default","tag":"API documentation","count":82},{"language":"default","tag":"Integrations","count":73},{"language":"default","tag":"Cloud","count":49},{"language":"default","tag":"Platform","count":39},{"language":"default","tag":"CLI reference","count":24},{"language":"default","tag":"Ownership","count":22},{"language":"default","tag":"AWS","count":21},{"language":"default","tag":"Organization API","count":21}]},"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":"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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/detection-exemptions/replace","slug":"/api-reference/detection-exemptions/replace","pageMetadata":{"title":"Replace a detection's exemptions","description":"Replace the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID.\n\nSend the `version` from the read as `If-Match`. The write is then rejected with a `412` (`VersionMismatch`) if the detection's configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no `412` is returned. Send it whenever the read returned a version, and omit it only when `version` was `null`, since there is then no stored configuration to match against.\n\n`version` covers the detection's whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile.\n\nA non-empty set is rejected with a `400` when the detection does not accept exemptions (`ExemptionsNotSupported`) or when an entry's `type` is outside the detection's `supportedExemptionTypes` (`UnsupportedExemptionType`). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today.\n\nOnly the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/tenant/profiles/{profileId}/detection-settings/{detectionId}/exemptions","href":"/api-reference/detection-exemptions/replace","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, 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(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Replace the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Send the \", _jsx(_components.code, {\n children: \"version\"\n }), \" from the read as \", _jsx(_components.code, {\n children: \"If-Match\"\n }), \". The write is then rejected with a \", _jsx(_components.code, {\n children: \"412\"\n }), \" (\", _jsx(_components.code, {\n children: \"VersionMismatch\"\n }), \") if the detection’s configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no \", _jsx(_components.code, {\n children: \"412\"\n }), \" is returned. Send it whenever the read returned a version, and omit it only when \", _jsx(_components.code, {\n children: \"version\"\n }), \" was \", _jsx(_components.code, {\n children: \"null\"\n }), \", since there is then no stored configuration to match against.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"version\"\n }), \" covers the detection’s whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A non-empty set is rejected with a \", _jsx(_components.code, {\n children: \"400\"\n }), \" when the detection does not accept exemptions (\", _jsx(_components.code, {\n children: \"ExemptionsNotSupported\"\n }), \") or when an entry’s \", _jsx(_components.code, {\n children: \"type\"\n }), \" is outside the detection’s \", _jsx(_components.code, {\n children: \"supportedExemptionTypes\"\n }), \" (\", _jsx(_components.code, {\n children: \"UnsupportedExemptionType\"\n }), \"). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Only the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Replace a detection's exemptions","description":"Replace the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID.\n\nSend the `version` from the read as `If-Match`. The write is then rejected with a `412` (`VersionMismatch`) if the detection's configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no `412` is returned. Send it whenever the read returned a version, and omit it only when `version` was `null`, since there is then no stored configuration to match against.\n\n`version` covers the detection's whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile.\n\nA non-empty set is rejected with a `400` when the detection does not accept exemptions (`ExemptionsNotSupported`) or when an entry's `type` is outside the detection's `supportedExemptionTypes` (`UnsupportedExemptionType`). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today.\n\nOnly the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/tenant/profiles/{profileId}/detection-settings/{detectionId}/exemptions","href":"/api-reference/detection-exemptions/replace","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"replaceDetectionExemptions","tags":["Detection exemptions"],"summary":"Replace","x-mint":{"metadata":{"title":"Replace a detection's exemptions"}},"description":"Replace the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID.\n\nSend the `version` from the read as `If-Match`. The write is then rejected with a `412` (`VersionMismatch`) if the detection's configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no `412` is returned. Send it whenever the read returned a version, and omit it only when `version` was `null`, since there is then no stored configuration to match against.\n\n`version` covers the detection's whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile.\n\nA non-empty set is rejected with a `400` when the detection does not accept exemptions (`ExemptionsNotSupported`) or when an entry's `type` is outside the detection's `supportedExemptionTypes` (`UnsupportedExemptionType`). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today.\n\nOnly the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.","security":["67d8ca13-43a4-4d27-939b-e16e88987b00"],"parameters":["099a771a-40f3-4e21-ac63-c05e6faecc0d","11892f49-bbff-4683-b49a-f040b99e1a39","4067426a-3dc9-4283-b8d9-0b7bbe4bf895","d99eb860-1274-43d0-a25b-99d825591fd9","49e2bf04-da8c-4ea8-84b2-f3e33f531142"],"requestBody":"53531d4f-eb6e-443c-bcd5-d713f2b00741","responses":{"200":"c4a763cc-cca2-46a3-bbd1-5daaba46e61f","400":"ad9f1faf-d92d-45cc-82c7-88733cb16f42","404":"f7dad583-4d35-481d-b6dd-44e05b61aefc","412":"62c2f3fe-ec3e-4a26-8cdf-a1f17959e72b","500":"33dd514f-d783-4c7b-bace-3d5bd3943581"},"method":"put","type":"path","servers":["b38a8fa7-5e16-452b-a830-972a2a70b197"],"path":"/v1/tenant/profiles/{profileId}/detection-settings/{detectionId}/exemptions","baseUrlOptions":["https://{region}.api.plerion.com"],"title":"Replace","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"099a771a-40f3-4e21-ac63-c05e6faecc0d":{"name":"Authorization","in":"header","description":"Bearer API Key. For example, \"Bearer {Tenant API Key}\"","required":true,"schema":{"type":"string","isRequired":true,"description":"Bearer API Key. For example, \"Bearer {Tenant API Key}\"","uniqueKey":"","typeLabel":"string"}},"11892f49-bbff-4683-b49a-f040b99e1a39":{"in":"header","name":"Content-Type","description":"application/json","schema":{"type":"string","description":"application/json","uniqueKey":"","typeLabel":"string"}},"4067426a-3dc9-4283-b8d9-0b7bbe4bf895":{"in":"header","name":"If-Match","description":"The `version` returned by the read, echoed back unchanged. When supplied, the write is rejected with a `412` unless it still matches the stored value. When omitted, the write applies unconditionally. Omit it only when the detection has no stored configuration on the profile yet.","schema":{"type":"string","description":"The `version` returned by the read, echoed back unchanged. When supplied, the write is rejected with a `412` unless it still matches the stored value. When omitted, the write applies unconditionally. Omit it only when the detection has no stored configuration on the profile yet.","uniqueKey":"","typeLabel":"string"}},"d99eb860-1274-43d0-a25b-99d825591fd9":{"name":"profileId","in":"path","description":"Profile ID, or the literal string `default` for the tenant's default profile. `default` covers only the integrations that have not been given a profile of their own, so on a tenant with more than one profile it does not reach the rest. Use [List profiles](/api-reference/profiles/list) to get the IDs.","required":true,"schema":{"type":"string","example":"default","isRequired":true,"description":"Profile ID, or the literal string `default` for the tenant's default profile. `default` covers only the integrations that have not been given a profile of their own, so on a tenant with more than one profile it does not reach the rest. Use [List profiles](/api-reference/profiles/list) to get the IDs.","uniqueKey":"","typeLabel":"string"}},"49e2bf04-da8c-4ea8-84b2-f3e33f531142":{"name":"detectionId","in":"path","description":"Detection ID. A finding reports the detection that produced it in its `detectionId` field.","required":true,"schema":{"type":"string","example":"PLERION-AWS-16","isRequired":true,"description":"Detection ID. A finding reports the detection that produced it in its `detectionId` field.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["exemptions"],"additionalProperties":false,"properties":{"exemptions":{"type":"array","description":"The complete exemption set for the detection. Send an empty array to clear it.","items":{"oneOf":[{"type":"object","description":"One exemption rule to write. The `type` decides which other fields apply, and which types a detection accepts is reported by `supportedExemptionTypes` on the read. The read returns `StoredDetectionExemption`, which is looser.","required":["type","condition","value"],"properties":{"type":{"type":"string","enum":["NAME_EXEMPTION"],"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"condition":{"type":"string","description":"How `value` is compared with the asset name. These are the Equals, Starts with, Ends with, and Contains options in the Plerion platform.","enum":["equals","starts-with","ends-with","contains"],"example":"starts-with","isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.0.condition","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Must be non-empty unless `condition` is `equals`. On the other three an empty value matches every asset name, which would exempt every finding for the detection.","example":"acme-sandbox-","isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.0.value","typeLabel":"string"},"reason":{"type":"string","description":"Why the finding is being accepted. Optional; entries configured in the Plerion platform may have none. Shown in the platform as Accepted risk, False positive, and Compensating control.","enum":["ACCEPTED_RISK","FALSE_POSITIVE","COMPENSATING_CONTROL"],"example":"ACCEPTED_RISK","uniqueKey":"exemptions.items.[INDEX].oneOf.0.reason","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"exemptions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"One exemption rule to write. The `type` decides which other fields apply, and which types a detection accepts is reported by `supportedExemptionTypes` on the read. The read returns `StoredDetectionExemption`, which is looser.","required":["type","tagKey","tagValue"],"properties":{"type":{"type":"string","enum":["TAG_EXEMPTION"],"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"tagKey":{"type":"object","required":["option","value"],"additionalProperties":false,"properties":{"option":{"type":"string","enum":["equals"],"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.1.tagKey.option","typeLabel":"enum\u003cstring>"},"value":{"type":"string","example":"environment","isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.1.tagKey.value","typeLabel":"string"}},"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.1.tagKey","typeLabel":"object"},"tagValue":{"type":"object","required":["option","value"],"properties":{"option":{"type":"string","description":"Use `any` to exempt every asset carrying the key, whatever its value.","enum":["equals","starts-with","ends-with","contains","any"],"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.1.tagValue.option","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Must be non-empty unless `option` is `any`, which ignores it, or `equals`, which then matches only an empty tag value.","example":"sandbox","isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.1.tagValue.value","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.1.tagValue","typeLabel":"object"},"reason":{"type":"string","description":"Why the finding is being accepted. Optional; entries configured in the Plerion platform may have none. Shown in the platform as Accepted risk, False positive, and Compensating control.","enum":["ACCEPTED_RISK","FALSE_POSITIVE","COMPENSATING_CONTROL"],"example":"ACCEPTED_RISK","uniqueKey":"exemptions.items.[INDEX].oneOf.1.reason","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"exemptions.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"One exemption rule to write. The `type` decides which other fields apply, and which types a detection accepts is reported by `supportedExemptionTypes` on the read. The read returns `StoredDetectionExemption`, which is looser.","required":["type","regions"],"properties":{"type":{"type":"string","enum":["REGION_EXEMPTION"],"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"regions":{"type":"array","items":{"type":"string","uniqueKey":"exemptions.items.[INDEX].oneOf.2.regions.items.[INDEX]","typeLabel":"string"},"example":["ap-southeast-2","us-west-2"],"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.2.regions","typeLabel":"string[]"},"reason":{"type":"string","description":"Why the finding is being accepted. Optional; entries configured in the Plerion platform may have none. Shown in the platform as Accepted risk, False positive, and Compensating control.","enum":["ACCEPTED_RISK","FALSE_POSITIVE","COMPENSATING_CONTROL"],"example":"ACCEPTED_RISK","uniqueKey":"exemptions.items.[INDEX].oneOf.2.reason","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"exemptions.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"One exemption rule to write. The `type` decides which other fields apply, and which types a detection accepts is reported by `supportedExemptionTypes` on the read. The read returns `StoredDetectionExemption`, which is looser.","required":["type","condition","value"],"properties":{"type":{"type":"string","enum":["PRINCIPAL_EXEMPTION"],"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"condition":{"type":"string","enum":["equals","starts-with","ends-with","contains"],"example":"equals","isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.3.condition","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Must be non-empty unless `condition` is `equals`. On the other three an empty value matches every principal.","example":"arn:aws:iam::111122223333:role/deployment","isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.3.value","typeLabel":"string"},"reason":{"type":"string","description":"Why the finding is being accepted. Optional; entries configured in the Plerion platform may have none. Shown in the platform as Accepted risk, False positive, and Compensating control.","enum":["ACCEPTED_RISK","FALSE_POSITIVE","COMPENSATING_CONTROL"],"example":"ACCEPTED_RISK","uniqueKey":"exemptions.items.[INDEX].oneOf.3.reason","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"exemptions.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"One exemption rule to write. The `type` decides which other fields apply, and which types a detection accepts is reported by `supportedExemptionTypes` on the read. The read returns `StoredDetectionExemption`, which is looser.","required":["type","apiId","routeKey"],"properties":{"type":{"type":"string","enum":["ROUTE_EXEMPTION"],"isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"apiId":{"type":"string","example":"a1b2c3d4e5","isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.4.apiId","typeLabel":"string"},"routeKey":{"type":"string","example":"GET /health","isRequired":true,"uniqueKey":"exemptions.items.[INDEX].oneOf.4.routeKey","typeLabel":"string"},"reason":{"type":"string","description":"Why the finding is being accepted. Optional; entries configured in the Plerion platform may have none. Shown in the platform as Accepted risk, False positive, and Compensating control.","enum":["ACCEPTED_RISK","FALSE_POSITIVE","COMPENSATING_CONTROL"],"example":"ACCEPTED_RISK","uniqueKey":"exemptions.items.[INDEX].oneOf.4.reason","typeLabel":"enum\u003cstring>"},"createdBy":{"type":"string","description":"Set when the entry was created in the Plerion platform. Send it back unchanged on an entry you read; omit it on a new one.","uniqueKey":"exemptions.items.[INDEX].oneOf.4.createdBy","typeLabel":"string"},"createdAt":{"type":"string","description":"Set when the entry was created in the Plerion platform. Send it back unchanged on an entry you read; omit it on a new one.","uniqueKey":"exemptions.items.[INDEX].oneOf.4.createdAt","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"exemptions.items.[INDEX].oneOf.4","typeLabel":"object"}],"uniqueKey":"exemptions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"exemptions","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"exemptions":[{"type":"NAME_EXEMPTION","condition":"starts-with","value":"acme-sandbox-","reason":"ACCEPTED_RISK"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"c4a763cc-cca2-46a3-bbd1-5daaba46e61f":{"description":"Exemptions replaced","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"The exemptions configured for one detection on one profile.","required":["profileId","detectionId","provider","supportsExemptions","supportedExemptionTypes","exemptions","version"],"properties":{"profileId":{"type":"string","format":"uuid","description":"The resolved profile ID. Requests addressed to `default` report the ID the default profile resolved to.","example":"7c9e6679-7425-40de-944b-e07fc1f90ae7","isRequired":true,"uniqueKey":"data.profileId","typeLabel":"string\u003cuuid>"},"detectionId":{"type":"string","example":"PLERION-AWS-16","isRequired":true,"uniqueKey":"data.detectionId","typeLabel":"string"},"provider":{"type":"string","description":"The provider the detection belongs to.","example":"AWS","isRequired":true,"uniqueKey":"data.provider","typeLabel":"string"},"supportsExemptions":{"type":"boolean","description":"Whether this detection accepts exemptions at all. A non-empty write to one that does not is rejected with a `400`.","example":true,"isRequired":true,"uniqueKey":"data.supportsExemptions","typeLabel":"boolean"},"supportedExemptionTypes":{"type":"array","description":"The exemption types that can clear a finding from this detection. Writing any other type is rejected, because it would be stored and then never take effect. Empty when the detection does not support exemptions.","items":{"type":"string","enum":["NAME_EXEMPTION","TAG_EXEMPTION","REGION_EXEMPTION","PRINCIPAL_EXEMPTION","ROUTE_EXEMPTION"],"uniqueKey":"data.supportedExemptionTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"example":["NAME_EXEMPTION","TAG_EXEMPTION","REGION_EXEMPTION"],"isRequired":true,"uniqueKey":"data.supportedExemptionTypes","typeLabel":"enum\u003cstring>[]"},"exemptions":{"type":"array","description":"The exemptions as stored. A detection that no longer supports exemptions can still report entries written while it did.","items":{"type":"object","description":"An exemption as stored. Send entries back unchanged when replacing the set. The fields vary by `type`, and `DetectionExemption` documents which belong to which.","required":["type"],"additionalProperties":true,"properties":{"type":{"type":"string","enum":["NAME_EXEMPTION","TAG_EXEMPTION","REGION_EXEMPTION","PRINCIPAL_EXEMPTION","ROUTE_EXEMPTION"],"isRequired":true,"uniqueKey":"data.exemptions.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","description":"Why the finding is being accepted. Optional; entries configured in the Plerion platform may have none. Shown in the platform as Accepted risk, False positive, and Compensating control.","enum":["ACCEPTED_RISK","FALSE_POSITIVE","COMPENSATING_CONTROL"],"example":"ACCEPTED_RISK","uniqueKey":"data.exemptions.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"condition":{"type":"string","example":"starts-with","uniqueKey":"data.exemptions.items.[INDEX].condition","typeLabel":"string"},"value":{"type":"string","example":"acme-sandbox-","uniqueKey":"data.exemptions.items.[INDEX].value","typeLabel":"string"},"tagKey":{"type":"object","properties":{"option":{"type":"string","example":"equals","uniqueKey":"data.exemptions.items.[INDEX].tagKey.option","typeLabel":"string"},"value":{"type":"string","example":"environment","uniqueKey":"data.exemptions.items.[INDEX].tagKey.value","typeLabel":"string"}},"uniqueKey":"data.exemptions.items.[INDEX].tagKey","typeLabel":"object"},"tagValue":{"type":"object","properties":{"option":{"type":"string","example":"equals","uniqueKey":"data.exemptions.items.[INDEX].tagValue.option","typeLabel":"string"},"value":{"type":"string","example":"test","uniqueKey":"data.exemptions.items.[INDEX].tagValue.value","typeLabel":"string"}},"uniqueKey":"data.exemptions.items.[INDEX].tagValue","typeLabel":"object"},"regions":{"type":"array","items":{"type":"string","uniqueKey":"data.exemptions.items.[INDEX].regions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.exemptions.items.[INDEX].regions","typeLabel":"string[]"},"apiId":{"type":"string","uniqueKey":"data.exemptions.items.[INDEX].apiId","typeLabel":"string"},"routeKey":{"type":"string","uniqueKey":"data.exemptions.items.[INDEX].routeKey","typeLabel":"string"},"createdBy":{"type":"string","uniqueKey":"data.exemptions.items.[INDEX].createdBy","typeLabel":"string"},"createdAt":{"type":"string","uniqueKey":"data.exemptions.items.[INDEX].createdAt","typeLabel":"string"}},"uniqueKey":"data.exemptions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.exemptions","typeLabel":"object[]"},"version":{"oneOf":[{"type":"string","description":"An opaque token identifying the detection's current configuration. Store it as a string and send it back unchanged as `If-Match` when replacing the set. Do not parse it, compare two of them, or order by it. The format is not part of this contract and can change. `null` when the detection has never been configured on this profile, in which case the replace request must omit the header.","isRequired":true,"uniqueKey":"data.version.oneOf.0","typeLabel":"string"},{"type":"null","description":"An opaque token identifying the detection's current configuration. Store it as a string and send it back unchanged as `If-Match` when replacing the set. Do not parse it, compare two of them, or order by it. The format is not part of this contract and can change. `null` when the detection has never been configured on this profile, in which case the replace request must omit the header.","isRequired":true,"uniqueKey":"data.version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.version","typeLabel":"string | null"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"profileId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","detectionId":"PLERION-AWS-16","provider":"AWS","supportsExemptions":true,"supportedExemptionTypes":["NAME_EXEMPTION","TAG_EXEMPTION","REGION_EXEMPTION"],"exemptions":[{"type":"NAME_EXEMPTION","reason":"ACCEPTED_RISK","condition":"starts-with","value":"acme-sandbox-","tagKey":{"option":"equals","value":"environment"},"tagValue":{"option":"equals","value":"test"},"regions":["\u003cstring>"],"apiId":"\u003cstring>","routeKey":"\u003cstring>","createdBy":"\u003cstring>","createdAt":"\u003cstring>"}],"version":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ad9f1faf-d92d-45cc-82c7-88733cb16f42":{"description":"Bad Request","content":{"application/json":{"schema":{"properties":{"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"field":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"f7dad583-4d35-481d-b6dd-44e05b61aefc":{"description":"Not Found","content":{"application/json":{"schema":{"properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"62c2f3fe-ec3e-4a26-8cdf-a1f17959e72b":{"description":"Precondition Failed","content":{"application/json":{"schema":{"properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","example":"VersionMismatch","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","example":"This detection was changed since the version you supplied. Re-read the exemptions and retry.","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"VersionMismatch","message":"This detection was changed since the version you supplied. Re-read the exemptions and retry."}]}}},"exampleType":"generated"}},"exampleType":"generated"},"33dd514f-d783-4c7b-bace-3d5bd3943581":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Internal server error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Internal server error"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"67d8ca13-43a4-4d27-939b-e16e88987b00":{"APIKey":{"type":"http","scheme":"bearer","bearerFormat":"apiKey","description":"Bearer API Key. For example, \"Bearer {Tenant API Key}\"","scopes":[],"schemeName":"APIKey"}}},"servers":{"b38a8fa7-5e16-452b-a830-972a2a70b197":{"url":"https://{region}.api.plerion.com","description":"Production API server - Select your preferred region","variables":{"region":{"default":"au","enum":["au","sg1","in1","us1"]}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"apiKey","description":"Bearer API Key. For example, \"Bearer {Tenant API Key}\"","scopes":[],"schemeName":"APIKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer API Key. For example, \"Bearer {Tenant API Key}\"","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"APIKey","name":"Authorization"}],"title":"APIKey"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"pleriondocs","siteName":"Plerion, Simplify Cloud Security - documentation","title":"Replace a detection's exemptions - Plerion, Simplify Cloud Security - documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T11:33:58.462Z","originalFileLocation":"api-reference/detection-exemptions/replace.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 the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID. Send the version from the read as If-Match. The write is then rejected with a 412 (VersionMismatch) if the detection\u0026#x27;s configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no 412 is returned. Send it whenever the read returned a version, and omit it only when version was null, since there is then no stored configuration to match against. version covers the detection\u0026#x27;s whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile. A non-empty set is rejected with a 400 when the detection does not accept exemptions (ExemptionsNotSupported) or when an entry\u0026#x27;s type is outside the detection\u0026#x27;s supportedExemptionTypes (UnsupportedExemptionType). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today. Only the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Plerion, Simplify Cloud Security - documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pleriondocs/xDuw_jwQ1ux0MEWx/_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/pleriondocs/xDuw_jwQ1ux0MEWx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pleriondocs/xDuw_jwQ1ux0MEWx/_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/pleriondocs/xDuw_jwQ1ux0MEWx/_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/pleriondocs/xDuw_jwQ1ux0MEWx/_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/pleriondocs/xDuw_jwQ1ux0MEWx/_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/pleriondocs/xDuw_jwQ1ux0MEWx/_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/pleriondocs/xDuw_jwQ1ux0MEWx/_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/pleriondocs/xDuw_jwQ1ux0MEWx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Replace a detection\u0026#x27;s exemptions - Plerion, Simplify Cloud Security - documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Replace the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID. Send the version from the read as If-Match. The write is then rejected with a 412 (VersionMismatch) if the detection\u0026#x27;s configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no 412 is returned. Send it whenever the read returned a version, and omit it only when version was null, since there is then no stored configuration to match against. version covers the detection\u0026#x27;s whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile. A non-empty set is rejected with a 400 when the detection does not accept exemptions (ExemptionsNotSupported) or when an entry\u0026#x27;s type is outside the detection\u0026#x27;s supportedExemptionTypes (UnsupportedExemptionType). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today. Only the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Plerion, Simplify Cloud Security - documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.plerion.com/api-reference/detection-exemptions/replace\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pleriondocs.mintlify.site/_mintlify/api/og/v2?division=Detection+Exemptions\u0026amp;title=Replace+a+detection%27s+exemptions\u0026amp;description=Replace+the+whole+exemption+set+for+one+detection+on+one+profile.+The+body+is+the+set+you+want+to+end+up+with%2C+so+read+the+current+set%2C+change+it%2C+and+send+all+\u0026amp;theme=910f8de94bb4838ffd304db5\u0026amp;signature=144059456a9d789065a68af7ff06fc2b4d887c1320539ffb856749f8784a30ca\">\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 a detection\u0026#x27;s exemptions - Plerion, Simplify Cloud Security - documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Replace the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID. Send the version from the read as If-Match. The write is then rejected with a 412 (VersionMismatch) if the detection\u0026#x27;s configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no 412 is returned. Send it whenever the read returned a version, and omit it only when version was null, since there is then no stored configuration to match against. version covers the detection\u0026#x27;s whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile. A non-empty set is rejected with a 400 when the detection does not accept exemptions (ExemptionsNotSupported) or when an entry\u0026#x27;s type is outside the detection\u0026#x27;s supportedExemptionTypes (UnsupportedExemptionType). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today. Only the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pleriondocs.mintlify.site/_mintlify/api/og/v2?division=Detection+Exemptions\u0026amp;title=Replace+a+detection%27s+exemptions\u0026amp;description=Replace+the+whole+exemption+set+for+one+detection+on+one+profile.+The+body+is+the+set+you+want+to+end+up+with%2C+so+read+the+current+set%2C+change+it%2C+and+send+all+\u0026amp;theme=910f8de94bb4838ffd304db5\u0026amp;signature=144059456a9d789065a68af7ff06fc2b4d887c1320539ffb856749f8784a30ca\">\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/pleriondocs/xDuw_jwQ1ux0MEWx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Plerion, Simplify Cloud Security - documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FFA500\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.plerion.com/api-reference/detection-exemptions/replace\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/detection-exemptions/replace.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.plerion.com/#organization\",\"name\":\"Plerion, Simplify Cloud Security - documentation\",\"url\":\"https://docs.plerion.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pleriondocs/GIwfwlVd5Zt2w0-r/logo/plerion.svg?fit=max\u0026auto=format\u0026n=GIwfwlVd5Zt2w0-r\u0026q=85\u0026s=86e89d26c3b52a61495baaf98faff52c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.plerion.com#website\",\"name\":\"Plerion, Simplify Cloud Security - documentation\",\"url\":\"https://docs.plerion.com\",\"publisher\":{\"@id\":\"https://docs.plerion.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.plerion.com/api-reference/detection-exemptions/replace#webpage\",\"url\":\"https://docs.plerion.com/api-reference/detection-exemptions/replace\",\"name\":\"Replace a detection's exemptions\",\"description\":\"Replace the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID. Send the version from the read as If-Match. The write is then rejected with a 412 (VersionMismatch) if the detection's configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no 412 is returned. Send it whenever the read returned a version, and omit it only when version was null, since there is then no stored configuration to match against. version covers the detection's whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile. A non-empty set is rejected with a 400 when the detection does not accept exemptions (ExemptionsNotSupported) or when an entry's type is outside the detection's supportedExemptionTypes (UnsupportedExemptionType). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today. Only the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.\",\"dateModified\":\"2026-11-18T11:33:58.462Z\",\"isPartOf\":{\"@id\":\"https://docs.plerion.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.plerion.com/api-reference/detection-exemptions/replace#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.plerion.com/api-reference/detection-exemptions/replace#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API documentation\",\"item\":\"https://docs.plerion.com/api-reference/findings/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Detection Exemptions\",\"item\":\"https://docs.plerion.com/api-reference/detection-exemptions/get\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Replace a detection's exemptions\",\"item\":\"https://docs.plerion.com/api-reference/detection-exemptions/replace\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.plerion.com/api-reference/detection-exemptions/replace#apireference\",\"headline\":\"Replace a detection's exemptions\",\"name\":\"Replace a detection's exemptions\",\"description\":\"Replace the whole exemption set for one detection on one profile. The body is the set you want to end up with, so read the current set, change it, and send all of it back. An empty array clears the set; there is no endpoint for a single entry and no exemption ID. Send the version from the read as If-Match. The write is then rejected with a 412 (VersionMismatch) if the detection's configuration changed in the meantime, so re-read and retry. Without the header the write applies unconditionally: a concurrent change is overwritten and no 412 is returned. Send it whenever the read returned a version, and omit it only when version was null, since there is then no stored configuration to match against. version covers the detection's whole configuration, not just its exemptions, so a change to its severity or parameters also invalidates it. Saving the profile in the Plerion platform rewrites every detection configured on it, which invalidates any version held against that profile. A non-empty set is rejected with a 400 when the detection does not accept exemptions (ExemptionsNotSupported) or when an entry's type is outside the detection's supportedExemptionTypes (UnsupportedExemptionType). Both would otherwise be stored and then never take effect. Clearing is always allowed, whatever the detection supports today. Only the exemptions change. A severity override or parameter set on the same detection is left alone, and exemptions written here apply to findings Plerion has already stored rather than waiting for the next scan.\",\"url\":\"https://docs.plerion.com/api-reference/detection-exemptions/replace\",\"mainEntityOfPage\":{\"@id\":\"https://docs.plerion.com/api-reference/detection-exemptions/replace#webpage\"},\"dateModified\":\"2026-11-18T11:33:58.462Z\",\"publisher\":{\"@id\":\"https://docs.plerion.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.plerion.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Plerion, Simplify Cloud Security - documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Plerion, Simplify Cloud Security - documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/detection-exemptions/replace.md","siteName":"Plerion, Simplify Cloud Security - documentation","nav":{"global":null,"tabs":[{"tab":"Welcome","pages":[{"title":"Welcome","href":""}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/getting-started"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"Quick start with Plerion API","href":"/api-reference"},{"title":"API categories","href":"/api-reference/api-categories"}]},{"group":"API documentation","pages":[{"group":"Findings","pages":[{"title":"List findings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/findings","href":"/api-reference/findings/list"}]},{"group":"Alerts","pages":[{"title":"List alerts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/alerts","href":"/api-reference/alerts/list"}]},{"group":"AWS Integration","pages":[{"title":"Get the tenant's external ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/external-id","href":"/api-reference/aws-integration/get-external-id"},{"title":"Create an onboarding token for a new integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/integrations/token","href":"/api-reference/aws-integration/generate-temporary-token"},{"title":"Get the onboarding CloudFormation template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/cloudformation-templates","href":"/api-reference/aws-integration/get-cloudformation-template"}]},{"group":"Tenant","pages":[{"title":"Get this tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant","href":"/api-reference/tenant/get"},{"title":"Get what this key can call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/openapi","href":"/api-reference/tenant/discover"},{"title":"Get this tenant's usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/usage","href":"/api-reference/tenant/usage"}]},{"group":"Integrations","pages":[{"title":"List inbound integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/integrations","href":"/api-reference/integrations/list-inbound-integrations"},{"title":"Replace an integration's user-defined tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/tenant/integrations/{integrationId}/user-defined-tags","href":"/api-reference/integrations/replace-user-defined-tags"}]},{"group":"Code Security","pages":[{"title":"Upload infrastructure code for scanning","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/shiftleft/iac/scan","href":"/api-reference/code-security/upload-iac"},{"title":"List code scans","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/shiftleft/iac/scans","href":"/api-reference/code-security/list-scans"},{"title":"List a code scan's findings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/shiftleft/iac/scans/{scanId}/findings","href":"/api-reference/code-security/list-findings"},{"title":"List a code scan's vulnerabilities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/shiftleft/iac/scans/{scanId}/vulnerabilities","href":"/api-reference/code-security/list-vulnerabilities"}]},{"group":"Compliance Frameworks","pages":[{"title":"List compliance frameworks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/compliance-frameworks","href":"/api-reference/compliance-frameworks/list"},{"title":"Download a compliance report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/integrations/{integrationId}/compliance-frameworks/{complianceId}/download","href":"/api-reference/compliance-frameworks/download-report"},{"title":"Request a compliance report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/integrations/{integrationId}/frameworks/{complianceFrameworkId}/reports","href":"/api-reference/compliance-frameworks/request-a-framework-report"}]},{"group":"Assets","pages":[{"title":"List assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/assets","href":"/api-reference/assets/list"},{"title":"Get an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/assets/{assetId}","href":"/api-reference/assets/get"},{"title":"Get an asset's SBOM","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/assets/{assetId}/sbom","href":"/api-reference/assets/get-sbom"},{"title":"Get an SBOM by asset ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/assets/sbom","href":"/api-reference/assets/get-sbom-by-asset-id"}]},{"group":"Asset Groups","pages":[{"title":"List asset groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/asset-groups","href":"/api-reference/asset-groups/list"},{"title":"Create an asset group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/asset-groups","href":"/api-reference/asset-groups/create"},{"title":"Get an asset group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/asset-groups/{assetGroupId}","href":"/api-reference/asset-groups/get"},{"title":"Delete an asset group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/tenant/asset-groups/{assetGroupId}","href":"/api-reference/asset-groups/delete"},{"title":"Update an asset group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/tenant/asset-groups/{assetGroupId}","href":"/api-reference/asset-groups/update"}]},{"group":"Well-Architected Frameworks","pages":[{"title":"List Well-Architected frameworks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/well-architected-frameworks","href":"/api-reference/well-architected-frameworks/list"},{"title":"Download a Well-Architected report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/integrations/{integrationId}/well-architected-frameworks/{wellArchitectedFrameworkId}/download","href":"/api-reference/well-architected-frameworks/download-report"},{"title":"Request a Well-Architected report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/integrations/{integrationId}/frameworks/{wellArchitectedFrameworkId}/reports","href":"/api-reference/well-architected-frameworks/request-framework-report"}]},{"group":"Vulnerabilities","pages":[{"title":"List vulnerabilities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/vulnerabilities","href":"/api-reference/vulnerabilities/list"},{"title":"List vulnerability exemptions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/profiles/{profileId}/vulnerability/exemptions","href":"/api-reference/vulnerabilities/list-vulnerability-exemptions-in-a-profile"},{"title":"Create a vulnerability exemption","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/profiles/{profileId}/vulnerability/exemptions","href":"/api-reference/vulnerabilities/create-a-vulnerability-exemption-in-a-profile"},{"title":"Get a vulnerability exemption","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/profiles/{profileId}/vulnerability/exemptions/{id}","href":"/api-reference/vulnerabilities/get-a-vulnerability-exemption-by-id"},{"title":"Delete a vulnerability exemption","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/tenant/profiles/{profileId}/vulnerability/exemptions/{id}","href":"/api-reference/vulnerabilities/delete-a-vulnerability-exemption-by-id"},{"title":"Update a vulnerability exemption","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/tenant/profiles/{profileId}/vulnerability/exemptions/{id}","href":"/api-reference/vulnerabilities/update-a-vulnerability-exemption-by-id"}]},{"group":"Profiles","pages":[{"title":"List profiles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/profiles","href":"/api-reference/profiles/list"}]},{"group":"Detection Exemptions","pages":[{"title":"Get a detection's exemptions","description":"Read the exemptions configured for one detection on one profile, together with whether that detection accepts exemptions and which types it accepts.\n\n`version` is an opaque token to send back unchanged as `If-Match` when replacing the set. It is `null` when the detection has never been configured on this profile, and a replace request must then omit the header.\n\nExemptions are reported as stored. A detection whose `supportsExemptions` is `false` can still hold entries written while it supported them, and you need to see them to clear them.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/profiles/{profileId}/detection-settings/{detectionId}/exemptions","href":"/api-reference/detection-exemptions/get"},{"title":"Replace a detection's exemptions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/tenant/profiles/{profileId}/detection-settings/{detectionId}/exemptions","href":"/api-reference/detection-exemptions/replace"}]},{"group":"Risks","pages":[{"title":"List risks","description":"Use the list risks API to retrieve and filter risks across the tenant.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/risks","href":"/api-reference/risks/list"},{"title":"Get a risk","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/risks/{riskId}","href":"/api-reference/risks/get"}]},{"group":"Audit Logs","pages":[{"title":"List audit logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/audit-logs","href":"/api-reference/audit-logs/list"}]},{"group":"Custom Checks","pages":[{"title":"List custom checks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/custom-checks","href":"/api-reference/custom-checks/list"},{"title":"Create a custom check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/custom-checks","href":"/api-reference/custom-checks/create"},{"title":"Get a custom check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/custom-checks/{customCheckId}","href":"/api-reference/custom-checks/get"},{"title":"Replace a custom check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/tenant/custom-checks/{customCheckId}","href":"/api-reference/custom-checks/update"},{"title":"Delete a custom check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/tenant/custom-checks/{customCheckId}","href":"/api-reference/custom-checks/delete"},{"title":"Start a custom check dry run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/custom-check-dry-runs","href":"/api-reference/custom-checks/start-dry-run"},{"title":"Get a dry run's status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/custom-check-dry-runs/{dryRunId}","href":"/api-reference/custom-checks/get-dry-run-status"}]},{"group":"Metrics","pages":[{"title":"Query metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/metrics","href":"/api-reference/metrics/query"}]},{"group":"Workload Scans","pages":[{"title":"Request a workload scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/workload/scans","href":"/api-reference/workload-scans/request"},{"title":"Get a workload scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/workload/scans/{scanId}","href":"/api-reference/workload-scans/get"}]},{"group":"Access Grants","pages":[{"title":"List AWS access grants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/aws/access-grants","href":"/api-reference/aws-access-grants/list"},{"title":"Get access grant counts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/aws/access-grants/stats","href":"/api-reference/aws-access-grants/stats"},{"title":"List external principals with access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/aws/access-grants/external-principals","href":"/api-reference/aws-access-grants/external-principals"},{"title":"Get an AWS access grant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/aws/access-grants/{id}","href":"/api-reference/aws-access-grants/get"},{"title":"Review an AWS access grant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/tenant/aws/access-grants/{id}","href":"/api-reference/aws-access-grants/update"}]},{"group":"Custom dashboards","pages":[{"title":"List the tenant's custom dashboards","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/custom-reports","href":"/api-reference/custom-dashboards/list"}]},{"group":"Preferences","pages":[{"title":"Get the tenant default home dashboard","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/preferences/home-dashboard","href":"/api-reference/preferences/get-tenant-default"},{"title":"Set the tenant default home dashboard","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/tenant/preferences/home-dashboard","href":"/api-reference/preferences/set-tenant-default"},{"title":"Clear the tenant default home dashboard","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/tenant/preferences/home-dashboard","href":"/api-reference/preferences/clear-tenant-default"}]},{"group":"Ownership","pages":[{"title":"List ownership rules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/ownership/rules","href":"/api-reference/ownership/list-rules"},{"title":"Set ownership rules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/tenant/ownership/rules","href":"/api-reference/ownership/set-rules"},{"title":"Preview ownership rules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/ownership/rules/preview","href":"/api-reference/ownership/preview-rules"},{"title":"Get ownership settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/ownership/settings","href":"/api-reference/ownership/get-settings"},{"title":"Update ownership settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/tenant/ownership/settings","href":"/api-reference/ownership/update-settings"},{"title":"List tag keys for ownership","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/ownership/tag-keys","href":"/api-reference/ownership/list-tag-keys"},{"title":"List integration tag keys for ownership","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/ownership/integration-tag-keys","href":"/api-reference/ownership/list-integration-tag-keys"},{"title":"Get ownership summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/ownership/summary","href":"/api-reference/ownership/get-summary"},{"title":"List assets with no owner, by reason","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/ownership/uncovered","href":"/api-reference/ownership/list-assets-with-no-owner"},{"title":"Explain an asset's owners","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/ownership/explain","href":"/api-reference/ownership/explain-an-assets-owners"},{"title":"Set owners on assets by hand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/tenant/assets/owner","href":"/api-reference/ownership/set-owners-on-assets"},{"title":"List owners","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/owners","href":"/api-reference/ownership/list-owners"},{"title":"Create an owner","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/owners","href":"/api-reference/ownership/create-an-owner"},{"title":"Delete several owners","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/owners/not-an-owner","href":"/api-reference/ownership/delete-several-owners"},{"title":"List owners that are likely duplicates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/owners/review","href":"/api-reference/ownership/list-likely-duplicates"},{"title":"Delete an owner","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/tenant/owners/{ownerId}","href":"/api-reference/ownership/delete-an-owner"},{"title":"Update an owner","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/tenant/owners/{ownerId}","href":"/api-reference/ownership/update-an-owner"},{"title":"Merge owners into one","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/owners/{ownerId}/merge","href":"/api-reference/ownership/merge-owners"},{"title":"Undo a merge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tenant/owners/{ownerId}/unmerge","href":"/api-reference/ownership/undo-a-merge"},{"title":"Add or remove the names an owner goes by","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/tenant/owners/{ownerId}/aliases","href":"/api-reference/ownership/update-an-owners-names"},{"title":"Get an owner's history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/owners/{ownerId}/history","href":"/api-reference/ownership/get-owner-history"},{"title":"Get the commands to retag an owner's assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tenant/owners/{ownerId}/retag-plan","href":"/api-reference/ownership/get-retag-commands"}]}]},{"group":"Organization API","pages":[{"group":"Roles","pages":[{"title":"List roles","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml get /v1/organization/roles","href":"/api-reference/roles/list-roles"},{"title":"Create a custom role","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml post /v1/organization/roles","href":"/api-reference/roles/create-a-custom-role"},{"title":"Get a role","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml get /v1/organization/roles/{roleId}","href":"/api-reference/roles/get-a-role"},{"title":"Update a custom role","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml put /v1/organization/roles/{roleId}","href":"/api-reference/roles/update-a-custom-role"},{"title":"Delete a custom role","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml delete /v1/organization/roles/{roleId}","href":"/api-reference/roles/delete-a-custom-role"}]},{"group":"Role assignments","pages":[{"title":"List role assignments","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml get /v1/organization/role-assignments","href":"/api-reference/role-assignments/list-role-assignments"},{"title":"Assign a role","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml post /v1/organization/role-assignments","href":"/api-reference/role-assignments/assign-a-role"},{"title":"Revoke a role","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml delete /v1/organization/role-assignments/{roleId}/{principalType}/{principalId}","href":"/api-reference/role-assignments/revoke-a-role"}]},{"group":"Permission catalog","pages":[{"title":"Get the permission catalog","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml get /v1/organization/permission-catalog","href":"/api-reference/permission-catalog/get-the-permission-catalog"}]},{"group":"Preferences","pages":[{"title":"Get a user's home dashboard","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml get /v1/organization/users/{userId}/preferences/home-dashboard","href":"/api-reference/preferences/get-a-users-home-dashboard"},{"title":"Set a user's home dashboard","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml put /v1/organization/users/{userId}/preferences/home-dashboard","href":"/api-reference/preferences/set-a-users-home-dashboard"},{"title":"Clear a user's home dashboard","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml delete /v1/organization/users/{userId}/preferences/home-dashboard","href":"/api-reference/preferences/clear-a-users-home-dashboard"},{"title":"Get a user's navigation","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml get /v1/organization/users/{userId}/preferences/navigation","href":"/api-reference/preferences/get-a-users-navigation"},{"title":"Set a user's navigation","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml put /v1/organization/users/{userId}/preferences/navigation","href":"/api-reference/preferences/set-a-users-navigation"},{"title":"Clear a user's navigation","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml delete /v1/organization/users/{userId}/preferences/navigation","href":"/api-reference/preferences/clear-a-users-navigation"},{"title":"Get a user group's home dashboard","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml get /v1/organization/user-groups/{groupId}/preferences/home-dashboard","href":"/api-reference/preferences/get-a-user-groups-home-dashboard"},{"title":"Set a user group's home dashboard","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml put /v1/organization/user-groups/{groupId}/preferences/home-dashboard","href":"/api-reference/preferences/set-a-user-groups-home-dashboard"},{"title":"Clear a user group's home dashboard","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml delete /v1/organization/user-groups/{groupId}/preferences/home-dashboard","href":"/api-reference/preferences/clear-a-user-groups-home-dashboard"},{"title":"Get a user group's navigation","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml get /v1/organization/user-groups/{groupId}/preferences/navigation","href":"/api-reference/preferences/get-a-user-groups-navigation"},{"title":"Set a user group's navigation","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml put /v1/organization/user-groups/{groupId}/preferences/navigation","href":"/api-reference/preferences/set-a-user-groups-navigation"},{"title":"Clear a user group's navigation","deprecated":null,"version":null,"openapi":"/api-reference/organization-openapi.yaml delete /v1/organization/user-groups/{groupId}/preferences/navigation","href":"/api-reference/preferences/clear-a-user-groups-navigation"}]}]},{"group":"SCIM API","pages":[{"group":"Discovery","pages":[{"title":"Supported SCIM protocol features","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml get /v1/organization/scim/v2/ServiceProviderConfig","href":"/api-reference/discovery/supported-scim-protocol-features"},{"title":"List supported resource types","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml get /v1/organization/scim/v2/ResourceTypes","href":"/api-reference/discovery/list-supported-resource-types"},{"title":"Get one resource type","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml get /v1/organization/scim/v2/ResourceTypes/{resourceTypeId}","href":"/api-reference/discovery/get-one-resource-type"},{"title":"List attribute schemas","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml get /v1/organization/scim/v2/Schemas","href":"/api-reference/discovery/list-attribute-schemas"},{"title":"Get one attribute schema","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml get /v1/organization/scim/v2/Schemas/{schemaUri}","href":"/api-reference/discovery/get-one-attribute-schema"}]},{"group":"Users","pages":[{"title":"List or filter users","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml get /v1/organization/scim/v2/Users","href":"/api-reference/users/list-or-filter-users"},{"title":"Create or adopt a user","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml post /v1/organization/scim/v2/Users","href":"/api-reference/users/create-or-adopt-a-user"},{"title":"Get one user","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml get /v1/organization/scim/v2/Users/{userId}","href":"/api-reference/users/get-one-user"},{"title":"Replace a user","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml put /v1/organization/scim/v2/Users/{userId}","href":"/api-reference/users/replace-a-user"},{"title":"Deprovision a user","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml delete /v1/organization/scim/v2/Users/{userId}","href":"/api-reference/users/deprovision-a-user"},{"title":"Partially update a user","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml patch /v1/organization/scim/v2/Users/{userId}","href":"/api-reference/users/partially-update-a-user"},{"title":"Search users with a request body","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml post /v1/organization/scim/v2/Users/.search","href":"/api-reference/users/search-users-with-a-request-body"}]},{"group":"Groups","pages":[{"title":"List or filter groups","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml get /v1/organization/scim/v2/Groups","href":"/api-reference/groups/list-or-filter-groups"},{"title":"Create a group","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml post /v1/organization/scim/v2/Groups","href":"/api-reference/groups/create-a-group"},{"title":"Get one group","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml get /v1/organization/scim/v2/Groups/{groupId}","href":"/api-reference/groups/get-one-group"},{"title":"Replace a group","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml put /v1/organization/scim/v2/Groups/{groupId}","href":"/api-reference/groups/replace-a-group"},{"title":"Delete a group","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml delete /v1/organization/scim/v2/Groups/{groupId}","href":"/api-reference/groups/delete-a-group"},{"title":"Partially update a group","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml patch /v1/organization/scim/v2/Groups/{groupId}","href":"/api-reference/groups/partially-update-a-group"},{"title":"Search groups with a request body","deprecated":null,"version":null,"openapi":"/api-reference/scim-openapi.yaml post /v1/organization/scim/v2/Groups/.search","href":"/api-reference/groups/search-groups-with-a-request-body"}]}]}]},{"tab":"CLI reference","pages":[{"title":"CLI reference","href":"/cli-reference/introduction"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"FAQs","hidden":true,"pages":[{"title":"FAQs","href":"/faqs"}]}]},"basePath":"","title":"Replace a detection's exemptions - Plerion, Simplify Cloud Security - documentation","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}