Skip to main content

Create Downtime

Creates a downtime in Datadog.

This node is also exposed as an AI Agent tool.

This node has 1 input port and 1 output port.

Common Properties​

Every node shares these.

  • Name — the node's display name on the canvas.
  • Color — the node's colour on the canvas.
  • Delay Before (sec) — wait this long before the node runs.
  • Delay After (sec) — wait this long after the node runs.
  • Continue On Error — carry on instead of failing the flow. Defaults to false.
info

When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.

Inputs​

PropertyFieldDescription
Client IDinClientIDClient ID from Connect node (optional if credentials provided)
ScopeinScopeScope to apply downtime to (e.g. host:myhost، env:production، or * for all)

Outputs​

PropertyFieldDescription
DowntimeoutDowntimeCreated downtime details including ID، scope، and schedule

Options​

PropertyFieldDescription
CredentialsoptCredentialsDatadog API keys
End (Unix Timestamp)optEndUnix timestamp for end
MessageoptMessageDowntime message
Monitor IDoptMonitorIDSpecific monitor ID to mute
Monitor TagsoptMonitorTagsComma-separated monitor tags to match
Mute First RecoveryoptMuteFirstRecoveryNotificationMute first recovery notification
SiteoptSiteDatadog site (defaults to datadoghq.com)
Start (Unix Timestamp)optStartUnix timestamp for start (defaults to now)
TimezoneoptTimezoneTimezone (e.g. America/New_York، UTC)

Requirements​

  • A Client ID from this package's Connect node, unless you set credentials directly on this node.
  • Datadog API Keys — API Key and Application Key for Datadog authentication
    • value — API Key (password, required). Your Datadog API key
    • application_key — Application Key (password, optional). Required for query and management operations (monitors, logs, downtimes)

Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.

List Downtimes · Cancel Downtime

Elsewhere in the package: Connect · Disconnect · Submit Metrics · Query Timeseries · Create Event · Create Monitor · Get Monitor · List Monitors · Mute Monitor · Query Logs and 2 more

See also​