Skip to main content

Datadog/security Suppressions

@webframp/datadog/security-suppressionsv2026.10.21.1· Apache-2.0· 5d agoBEHAVIORS
01README

Datadog Security Suppressions — suppression rule management

02Release Notes

2026.10.21.1

Changed: The README now shows how to store the API key and application key in a datadog vault and wire them with ${{ vault.get("datadog", "API_KEY") }} and ${{ vault.get("datadog", "APP_KEY") }}. The previous example passed DD_API_KEY and DD_APP_KEY as literal global arguments, which swamp rejects for sensitive arguments.

Changed: The apiKey and appKey descriptions now say to supply them with a vault.get expression. Both were already marked sensitive.

Upgrade note: Documentation and argument descriptions only. Methods, arguments, resource schemas and stored data are unchanged.

03Behaviors1
@webframp/datadog/security-suppressionsv2026.10.21.1datadog/security_suppressions.ts

Global Arguments

ArgumentTypeDescription
apiKeystringDatadog API key (DD-API-KEY). Wire it with ${{ vault.get("datadog", "API_KEY") }}; never pass the literal value.
appKeystringDatadog application key (DD-APPLICATION-KEY). Wire it with ${{ vault.get("datadog", "APP_KEY") }}; never pass the literal value.
site?enumDatadog site
fn list_security_monitoring_suppressions(query?: string, sort?: string)
Get all suppression rules
ArgumentTypeDescription
query?stringQuery string.
sort?stringAttribute used to sort the list of suppression rules. Prefix with `-` to sort...
fn create_security_monitoring_suppression(data_exclusion_query?: string, description?: string, enabled: boolean, expiration_date?: number, name: string, rule_query: string, start_date?: number, suppression_query?: string, tags?: array)
Create a suppression rule
ArgumentTypeDescription
data_exclusion_query?stringAn exclusion query on the input data of the security rules, which could be lo...
description?stringA description for the suppression rule.
enabledbooleanWhether the suppression rule is enabled.
expiration_date?numberA Unix millisecond timestamp giving an expiration date for the suppression ru...
namestringThe name of the suppression rule.
rule_querystringThe rule query of the suppression rule, with the same syntax as the search ba...
start_date?numberA Unix millisecond timestamp giving the start date for the suppression rule. ...
suppression_query?stringThe suppression query of the suppression rule. If a signal matches this query...
tags?arrayList of tags associated with the suppression rule.
fn get_suppressions_affecting_future_rule(calculatedFields?: array, cases: array, filters?: array, groupSignalsBy?: array, hasExtendedTitle?: boolean, isEnabled: boolean, message: string, name: string, options: unknown, queries: array, referenceTables?: array, schedulingOptions?: unknown, tags?: array, thirdPartyCases?: array, type?: unknown)
Get suppressions affecting future rule
ArgumentTypeDescription
calculatedFields?arrayCalculated fields. Only allowed for scheduled rules - in other words, when sc...
casesarrayCases for generating signals.
filters?arrayAdditional queries to filter matched events before they are processed. This f...
groupSignalsBy?arrayAdditional grouping to perform on top of the existing groups in the query sec...
hasExtendedTitle?booleanWhether the notifications include the triggering group-by values in their title.
isEnabledbooleanWhether the rule is enabled.
messagestringMessage for generated signals.
namestringThe name of the rule.
optionsunknown
queriesarrayQueries for selecting logs which are part of the rule.
referenceTables?arrayReference tables for the rule.
schedulingOptions?unknown
tags?arrayTags for generated signals.
thirdPartyCases?arrayCases for generating signals from third-party rules. Only available for third...
type?unknown
fn get_suppressions_affecting_rule(rule_id: string)
Get suppressions affecting a specific rule
ArgumentTypeDescription
rule_idstringThe ID of the rule.
fn validate_security_monitoring_suppression(data_exclusion_query?: string, description?: string, enabled: boolean, expiration_date?: number, name: string, rule_query: string, start_date?: number, suppression_query?: string, tags?: array)
Validate a suppression rule
ArgumentTypeDescription
data_exclusion_query?stringAn exclusion query on the input data of the security rules, which could be lo...
description?stringA description for the suppression rule.
enabledbooleanWhether the suppression rule is enabled.
expiration_date?numberA Unix millisecond timestamp giving an expiration date for the suppression ru...
namestringThe name of the suppression rule.
rule_querystringThe rule query of the suppression rule, with the same syntax as the search ba...
start_date?numberA Unix millisecond timestamp giving the start date for the suppression rule. ...
suppression_query?stringThe suppression query of the suppression rule. If a signal matches this query...
tags?arrayList of tags associated with the suppression rule.
fn get_security_monitoring_suppression(suppression_id: string)
Get a suppression rule
ArgumentTypeDescription
suppression_idstringThe ID of the suppression rule
fn update_security_monitoring_suppression(suppression_id: string, data_exclusion_query?: string, description?: string, enabled?: boolean, expiration_date?: number, name?: string, rule_query?: string, start_date?: number, suppression_query?: string, tags?: array, version?: number)
Update a suppression rule
ArgumentTypeDescription
suppression_idstringThe ID of the suppression rule
data_exclusion_query?stringAn exclusion query on the input data of the security rules, which could be lo...
description?stringA description for the suppression rule.
enabled?booleanWhether the suppression rule is enabled.
expiration_date?numberA Unix millisecond timestamp giving an expiration date for the suppression ru...
name?stringThe name of the suppression rule.
rule_query?stringThe rule query of the suppression rule, with the same syntax as the search ba...
start_date?numberA Unix millisecond timestamp giving the start date for the suppression rule. ...
suppression_query?stringThe suppression query of the suppression rule. If a signal matches this query...
tags?arrayList of tags associated with the suppression rule.
version?numberThe current version of the suppression. This is optional, but it can help pre...
fn delete_security_monitoring_suppression(suppression_id: string)
Delete a suppression rule
ArgumentTypeDescription
suppression_idstringThe ID of the suppression rule
fn get_suppression_version_history(suppression_id: string)
Get a suppression's version history
ArgumentTypeDescription
suppression_idstringThe ID of the suppression rule

Resources

security_monitoring_suppressions(infinite)— Get all suppression rules
security_monitoring_suppression(infinite)— Create a suppression rule
suppressions_affecting_future_rule(infinite)— Get suppressions affecting future rule
suppressions_affecting_rule(infinite)— Get suppressions affecting a specific rule
validate_security_monitoring_suppression(infinite)— Validate a suppression rule
suppression_version_history(infinite)— Get a suppression's version history
04Previous Versions12
2026.10.15.1Apache-2.0

2026.10.15.1

Changed: Generated tests now include one execution test per method, so every method is covered. Nothing behavioral changed in the model code, schemas or resources.

2026.10.14.1Apache-2.0(was none)

2026.10.14.1

Added: The manifest now declares license: Apache-2.0 (SPDX). The registry quality rubric scores a declared license separately from the bundled LICENSE.md.

Upgrade note: Metadata only. No code, schema, or behavioral changes.

2026.10.07.1

Fixed: The shared API helper no longer throws on a successful response with an empty body (such as 202 Accepted); it returns an empty result. Paginated list requests tolerate an empty page body the same way. A body that is not valid JSON now fails with an error naming the HTTP method, path, and status, with a snippet of the body.

Upgrade note: Only the shared helper changed. No methods, arguments, schemas, or resources changed, so no migration is needed and existing stored resources remain valid.

2026.09.18.1

2026.09.18.1

Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the repo. No behavioral changes in this extension.

2026.09.15.1

2026.09.15.1

Changed: Bump zod 4.4.3 → 4.6.5

2026.09.08.1

Added: Initial code-generated release of @webframp/datadog/security-suppressions with 9 methods covering the Datadog security suppressions API surface.

2026.09.08.1

2026.09.08.1

Added: Initial code-generated release of @webframp/datadog/security-suppressions with 9 methods covering the Datadog security suppressions API surface.

2026.08.28.2

2026.08.28.2

Hardened codegen: instance names sanitized against path traversal; string schema patterns emit regex validation; output schemas passthrough unknown fields.

2026.08.28.1

2026.08.28.1

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.26.2

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.24.1

2026.08.24.1

Added: Output metadata attributes for observability.

  • durationMs: Method execution duration in milliseconds.
  • collectedBy: Extension name that produced the data.
  • fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.21.2

2026.08.21.2

Changed: Error messages and input validation are more specific.

  • API errors now name the HTTP method and path that was attempted (e.g. Datadog API HTTP 404: GET /api/v2/security_monitoring/configuration/suppressions/abc-123) instead of just the raw status code and response body.
  • A network-level failure (DNS error, connection reset, timeout) reaching the Datadog API now raises Datadog API request failed: <METHOD> <path>: <reason> instead of an unlabeled fetch error.
  • suppression_id is now rejected up front if empty on every method that takes it, instead of building a malformed request path.
  • get_suppressions_affecting_future_rule now rejects an empty cases or queries array before making a request, instead of letting Datadog return an opaque validation error for a rule preview with no cases or queries.

No changes to request/response shapes or existing successful-path behavior.

2026.08.21.1

Changed: Tightened and clarified Zod schemas as part of a repo-wide schema audit.

  • Added .min(1) to apiKey and appKey in the global arguments schema — both are sent directly as request headers, and an empty value would never be accepted by the Datadog API.
  • Added descriptions to previously undocumented options, schedulingOptions, and type arguments on get_suppressions_affecting_future_rule.

No behavioral changes — these are documentation and validation tightenings only.

2026.07.20.11

Added: Initial code-generated release of @webframp/datadog/security-suppressions with 9 methods covering the Datadog security suppressions API surface.

2026.08.21.1

2026.08.21.1

Changed: Tightened and clarified Zod schemas as part of a repo-wide schema audit.

  • Added .min(1) to apiKey and appKey in the global arguments schema — both are sent directly as request headers, and an empty value would never be accepted by the Datadog API.
  • Added descriptions to previously undocumented options, schedulingOptions, and type arguments on get_suppressions_affecting_future_rule.

No behavioral changes — these are documentation and validation tightenings only.

2026.07.20.11

Added: Initial code-generated release of @webframp/datadog/security-suppressions with 9 methods covering the Datadog security suppressions API surface.

2026.07.20.11

2026.07.20.11

Added: Initial code-generated release of @webframp/datadog/security-suppressions with 9 methods covering the Datadog security suppressions API surface.

05Stats
A
100 / 100
Downloads
36
Archive size
18.4 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
06Platforms
07Labels