Datadog/downtimes

@webframp/datadog/downtimesv2026.10.21.1· Apache-2.0· 5d agoBEHAVIORS

01README

Datadog Downtimes — scheduled downtime management for monitors

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/downtimesv2026.10.21.1datadog/downtimes.ts

Global Arguments

Argument	Type	Required	Description
apiKey	string	yes	Datadog API key (DD-API-KEY). Wire it with ${{ vault.get("datadog", "API_KEY") }}; never pass the literal value.
appKey	string	yes	Datadog application key (DD-APPLICATION-KEY). Wire it with ${{ vault.get("datadog", "APP_KEY") }}; never pass the literal value.
site?	enum	no	Datadog site

fn list_downtimes(current_only?: boolean, include?: string)

Get all downtimes

Argument	Type	Required	Description
current_only?	boolean	no	Only return downtimes that are active when the request is made.
include?	string	no	Comma-separated list of resource paths for related resources to include in th...

fn create_downtime(display_timezone?: unknown, message?: unknown, monitor_identifier: unknown, mute_first_recovery_notification?: unknown, notify_end_states?: unknown, notify_end_types?: unknown, schedule?: unknown, scope: unknown)

Schedule a downtime

Argument	Type	Required
display_timezone?	unknown	no
message?	unknown	no
monitor_identifier	unknown	yes
mute_first_recovery_notification?	unknown	no
notify_end_states?	unknown	no
notify_end_types?	unknown	no
schedule?	unknown	no
scope	unknown	yes

fn get_downtime(downtime_id: string, include?: string, with_run_as?: boolean)

Get a downtime

Argument	Type	Required	Description
downtime_id	string	yes	ID of the downtime to fetch.
include?	string	no	Comma-separated list of resource paths for related resources to include in th...
with_run_as?	boolean	no	If `true`, include the `run_as` attribute in the response, which lists the pr...

fn update_downtime(downtime_id: string, display_timezone?: unknown, message?: unknown, monitor_identifier?: unknown, mute_first_recovery_notification?: unknown, notify_end_states?: unknown, notify_end_types?: unknown, schedule?: unknown, scope?: unknown)

Update a downtime

Argument	Type	Required	Description
downtime_id	string	yes	ID of the downtime to update.
display_timezone?	unknown	no
message?	unknown	no
monitor_identifier?	unknown	no
mute_first_recovery_notification?	unknown	no
notify_end_states?	unknown	no
notify_end_types?	unknown	no
schedule?	unknown	no
scope?	unknown	no

fn cancel_downtime(downtime_id: string)

Cancel a downtime

Argument	Type	Required	Description
downtime_id	string	yes	ID of the downtime to cancel.

fn list_monitor_downtimes(monitor_id: string)

Get active downtimes for a monitor

Argument	Type	Required	Description
monitor_id	string	yes	The id of the monitor.

Resources

downtimes(infinite)— Get all downtimes

downtime(infinite)— Schedule a downtime

monitor_downtimes(infinite)— Get active downtimes for a monitor

04Previous Versions13

2026.10.14.1Apache-2.0(was none)Oct 14, 2026

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.25.1Sep 25, 2026

2026.09.25.1

Added: get_downtime can request preview run_as principal assignments from Datadog.

Changed: Downtime resources now expose run_as assignments returned by Datadog.

2026.09.18.1Sep 20, 2026

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.1Sep 15, 2026

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/downtimes with 6 methods covering the Datadog downtimes API surface.

2026.09.08.1Sep 9, 2026

2026.09.08.1

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

2026.08.28.2Aug 28, 2026

2026.08.28.2

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

updated labels

2026.08.28.1Aug 28, 2026

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.2Aug 27, 2026

2026.08.26.2

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

2026.08.25.1Aug 26, 2026

2026.08.25.1

Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.

updated labels

2026.08.24.1Aug 24, 2026

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.2Aug 22, 2026

2026.08.21.2

Changed: Every Datadog API call made by this model (via the shared _lib/api.ts helper) now names the HTTP method and path in its error message, instead of a bare "Datadog API HTTP 500: ...". A failure now reads, for example, Datadog API POST /api/v2/dora/deployment failed with HTTP 500: ... rather than just the status code and response body. Network-level failures (DNS, connection reset, etc.) that previously surfaced as a raw TypeError now also say which Datadog operation was being attempted.

No changes to method arguments, resource schemas, or successful-call behavior — only error paths are affected.

2026.08.21.1Aug 21, 2026

2026.08.21.1

Changed: Schema-only tightening pass, no behavioral change.

Added .min(1) to apiKey/appKey in the global arguments and to the required downtime_id/monitor_id identifiers on the get, update, cancel, and list-monitor-downtimes methods, so empty identifiers are rejected before making an API call.
Added .describe() to the previously undocumented display_timezone, message, monitor_identifier, mute_first_recovery_notification, notify_end_states, notify_end_types, schedule, and scope arguments on the create_downtime and update_downtime methods.