Skip to main content
Datadog logo
  • Category: server monitoring
  • Auth: OAUTH2, API_KEY, BEARER_TOKEN
  • Composio-managed OAuth available? No
  • Tools: 249
  • Triggers: 0
  • Slug: DATADOG
  • Version: 20261101_00

Tools

Slug: DATADOG_ABORT_TEST_FILE_MULTIPART_UPLOADAbort a multipart upload of a test file. Uses POST /api/v2/synthetics/tests/{public_id}/files/multipart-upload-abort. Supply the documented payload in body. Datadog permission(s): synthetics_write, synthetics_create_edit_trigger.

Input Parameters

object
required
The documented request body.
string
required
The public ID of the Synthetic test.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_ACKNOWLEDGE_ON_CALL_PAGEAcknowledge an On-Call page by ID via POST /api/v2/on-call/pages/{page_id}/acknowledge. Requests use navy.oncall.datadoghq.com unless the configured base URL already has an on-call host.

Input Parameters

string
required
The page ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_ADD_TEST_TO_SYNTHETICS_DOWNTIMEAdd a test to a Synthetics downtime. Uses PUT /api/v2/synthetics/downtimes/{downtime_id}/tests/{test_id}. Datadog permission(s): synthetics_write.

Input Parameters

string
required
The public ID of the Synthetics test to associate with the downtime.
string
required
The ID of the downtime.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_AGGREGATE_LOGSAggregate Datadog logs without downloading raw events for counts, unique-value counts, percentiles, numeric statistics, grouped breakdowns, and values over time. Results can be partial when a query times out or returns warnings.

Input Parameters

object
Continues an alphabetically sorted aggregate query.
object
Log query, time range, indexes, and storage tier to analyze.
array
Calculations to perform; defaults to total log count.
array
Facets used to divide results into buckets.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CANCEL_DOWNTIMECancel a downtime. Uses DELETE /api/v2/downtime/{downtime_id}. Datadog permission(s): monitors_downtime.

Input Parameters

string
required
ID of the downtime to cancel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CHECK_CAN_DELETE_MONITORCheck if the given monitors can be deleted. Uses GET /api/v1/monitor/can_delete. Datadog permission(s): monitors_read.

Input Parameters

array
required
The IDs of the monitor to check.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CHECK_CAN_DELETE_SLOCheck if SLOs can be safely deleted without disrupting resources such as dashboards. Uses GET /api/v1/slo/can_delete. Datadog permission(s): slos_read.

Input Parameters

string
required
A comma separated list of the IDs of the service level objectives objects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_COMPLETE_TEST_FILE_MULTIPART_UPLOADComplete a multipart upload of a test file. Uses POST /api/v2/synthetics/tests/{public_id}/files/multipart-upload-complete. Supply the documented payload in body. Datadog permission(s): synthetics_write, synthetics_create_edit_trigger.

Input Parameters

object
required
The documented request body.
string
required
The public ID of the Synthetic test.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_API_TESTCreate an API test. Uses POST /api/v1/synthetics/tests/api. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
Details of the test to create.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_DASHBOARDCreate a dashboard in Datadog. Dashboards provide customizable visualizations for monitoring your infrastructure, applications, and business metrics in a unified view.

Input Parameters

array
Tags to associate with the dashboard
string
required
Dashboard title
array
required
List of widgets to include in the dashboard
string
Dashboard description
string ("ordered" | "free")
Dashboard layout type.
array
List of users to notify of dashboard changes
array
Template variables for dynamic dashboards

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_DASHBOARD_LISTCreate a dashboard list. Uses POST /api/v1/dashboard/lists/manual. Supply the documented payload in body. Datadog permission(s): dashboards_write.

Input Parameters

object
required
Create a dashboard list request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_DASHBOARD_LIST_ITEMSAdd Items to a Dashboard List. Uses POST /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards. Supply the documented payload in body.

Input Parameters

object
required
Dashboards to add to the dashboard list.
integer
required
ID of the dashboard list to add items to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_DERIVED_METRICCreate a derived metric. Uses POST /api/v2/metrics/derived-metrics. Supply the documented payload in body. Datadog permission(s): metric_tags_write.

Input Parameters

object
required
The documented request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_DOWNTIMECreates a new downtime in Datadog to suppress alerts during maintenance windows or planned outages. Useful for preventing false alarms during deployments or maintenance.

Input Parameters

integer
UNIX timestamp when downtime should end
array
required
Scope to apply downtime to (host, service, or monitor tags)
integer
UNIX timestamp when downtime should start. If not provided, starts immediately
string
Message to include with the downtime
string
Timezone for the downtime (e.g., ‘UTC’, ‘America/New_York’)
integer
Monitor ID to schedule downtime for (optional, can use scope instead)
object
Downtime recurrence configuration.
array
Monitor tags to match for downtime

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_ESCALATION_POLICYCreates a Datadog On-Call escalation policy.

Input Parameters

object
required
The Datadog On-Call escalation policy to create (JSON:API data object).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_EVENTCreates a new event in Datadog. Events are useful for tracking deployments, outages, configuration changes, and other important occurrences.

Input Parameters

string
Host name associated with the event
array
List of tags to associate with the event
string
required
Event text/description (supports Markdown)
string
required
Event title (limited to 100 characters)
string ("normal" | "low")
Event priority.
string ("error" | "warning" | "info" | "success")
Alert type.
string
Device name associated with the event
integer
UNIX timestamp when the event occurred. If not provided, current time is used
string
Key for aggregating events together
string
Source type name (e.g., ‘jenkins’, ‘docker’, ‘ansible’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_EVENT_V2Post an event. Uses POST /api/v2/events. Supply the documented payload in body. Uses the documented regional intake endpoint.

Input Parameters

object
required
Event creation request payload.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_GLOBAL_VARIABLECreate a global variable. Uses POST /api/v1/synthetics/variables. Supply the documented payload in body. Datadog permission(s): synthetics_global_variable_write.

Input Parameters

object
required
Details of the global variable to create.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_GRAPH_SNAPSHOTCreate a hosted PNG snapshot from a metric query or graph definition. The returned snapshot URL may take time to become available.

Input Parameters

integer
required
POSIX timestamp in seconds for the end of the graph’s time range.
integer
required
POSIX timestamp in seconds for the start of the graph’s time range.
string
Title displayed on the graph. Omit it to create a graph without a title.
integer
Graph width in pixels. Omit it to use the graph’s original width.
integer
Graph height in pixels. Omit it to use the graph’s original height.
string
Single-line JSON graph definition to render. Provide exactly one of graph_def or metric_query.
string
Query that adds event bands to the graph.
string
Datadog metric query to render. Provide exactly one of metric_query or graph_def.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_INCIDENT_IMPACTCreate an incident impact. Uses POST /api/v2/incidents/{incident_id}/impacts. Supply the documented payload in body. Datadog permission(s): incident_write.

Input Parameters

object
required
Incident impact payload.
array
Specifies which related resources should be included in the response.
string
required
The UUID of the incident.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_MONITORCreates a new Datadog monitor to track metrics, logs, or other data sources with configurable alerting thresholds and notifications.

Input Parameters

string
required
Name of the monitor
array
List of tags to assign to the monitor
string ("metric alert" | "service check" | "event alert" | "query alert" | "composite" | "log alert")
required
Type of monitor.
string
required
Query that defines what the monitor tracks Query syntax must match the monitor type exactly — a mismatch will cause creation to fail.
string
Message to include in notifications (supports @mentions and markdown)
object
Monitor configuration options.
integer
Priority level (1-5, where 1 is highest)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_MONITOR_CONFIG_POLICYCreate a monitor configuration policy. Uses POST /api/v2/monitor/policy. Supply the documented payload in body. Datadog permission(s): monitor_config_policy_write.

Input Parameters

object
required
Create a monitor configuration policy request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_MONITOR_NOTIFICATION_RULECreate a monitor notification rule. Uses POST /api/v2/monitor/notification_rule. Supply the documented payload in body. Datadog permission(s): monitor_config_policy_write.

Input Parameters

object
required
Request body to create a monitor notification rule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_NOTEBOOKCreate a notebook. Uses POST /api/v1/notebooks. Supply the documented payload in body. Datadog permission(s): notebooks_write.

Input Parameters

object
required
The JSON description of the notebook you want to create.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_NOTIFICATION_CHANNELCreates an On-Call notification channel for a Datadog user.

Input Parameters

object
required
The On-Call notification channel to create (JSON:API data object).
string
required
Unique identifier of the Datadog user who will own the On-Call notification channel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_NOTIFICATION_RULECreates an On-Call notification rule for a Datadog user.

Input Parameters

object
required
The On-Call notification rule to create (JSON:API data object).
string
required
Unique identifier of the Datadog user whose On-Call notification rule will be created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_ON_CALL_PAGECreate a Datadog On-Call page to notify a target team or user about an issue. Supply a title, urgency, and target, with an optional description and tags; the response can include the created page’s ID.

Input Parameters

object
required
The documented request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_OR_UPDATE_SERVICE_DEFINITIONSCreate or update service definition. Uses POST /api/v2/services/definitions. Supply the documented payload in body. Datadog permission(s): apm_service_catalog_write.

Input Parameters

string
required
Service Definition YAML/JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_PUBLIC_DASHBOARDCreate a shared dashboard. Uses POST /api/v1/dashboard/public. Supply the documented payload in body. Datadog permission(s): dashboards_public_share, dashboards_embed_share, dashboards_invite_share.

Input Parameters

object
required
Create a shared dashboard request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_SCHEDULECreates a Datadog On-Call schedule.

Input Parameters

object
required
The Datadog On-Call schedule to create (JSON:API data object).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_SCHEDULE_OVERRIDESCreate On-Call schedule overrides. Uses POST /api/v2/on-call/schedules/{schedule_id}/overrides. Supply the documented payload in body. Datadog permission(s): on_call_respond, on_call_write.

Input Parameters

object
required
The documented request body.
string
Comma-separated list of included relationships to be returned. Allowed values: user, overridden_user, user.color.
string
required
The ID of the schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_SLOCreate a metric-based or monitor-based Service Level Objective (SLO) in Datadog to track service reliability targets.

Input Parameters

string
required
SLO display name
array
Tags to associate with the SLO (format: ‘key:value’)
string ("metric" | "monitor")
required
SLO type.
object
Query specification for metric-based SLOs.
array
List of groups for the SLO scope
array
required
List of SLO target thresholds
string
Optional description of the SLO
array
Monitor IDs for monitor-based SLOs

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_SYNTHETIC_API_TESTCreate a synthetic API test in Datadog for proactive monitoring of API uptime, performance, and functionality. The test can be configured with execution locations and a live or paused status.

Input Parameters

string
required
Name of the synthetic test
array
Tags to associate with the test
string
Type of synthetic test (always ‘api’ for API tests)
object
required
Test configuration including request and assertions
string ("live" | "paused")
Test status.
string
Message to include in notifications
object
required
Test execution options
string ("http" | "ssl" | "tcp" | "dns" | "icmp")
Subtype of test.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_SYNTHETICS_BROWSER_TESTCreate a browser test. Uses POST /api/v1/synthetics/tests/browser. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
Details of the test to create.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_SYNTHETICS_DOWNTIMECreate a Synthetics downtime. Uses POST /api/v2/synthetics/downtimes. Supply the documented payload in body. Datadog permission(s): synthetics_write, synthetics_default_settings_write.

Input Parameters

object
required
The documented request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_SYNTHETICS_MOBILE_TESTCreate a mobile test. Uses POST /api/v1/synthetics/tests/mobile. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
Details of the test to create.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_SYNTHETICS_NETWORK_TESTCreate a Network Path test. Uses POST /api/v2/synthetics/tests/network. Supply the documented payload in body. Datadog permission(s): synthetics_write, synthetics_create_edit_trigger.

Input Parameters

object
required
The documented request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_SYNTHETICS_SUITECreate a test suite. Uses POST /api/v2/synthetics/suites. Supply the documented payload in body. Datadog permission(s): synthetics_write, synthetics_create_edit_trigger.

Input Parameters

object
required
The documented request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_TAG_CONFIGURATIONCreate a tag configuration. Uses POST /api/v2/metrics/{metric_name}/tags. Supply the documented payload in body. Datadog permission(s): metric_tags_write.

Input Parameters

object
required
The documented request body.
string
required
The name of the metric.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_CREATE_WEBHOOKCreate a webhook in Datadog. Registers a named destination endpoint; each monitor must explicitly reference the webhook by name in its message or notification settings for alerts to be delivered.

Input Parameters

string
required
URL endpoint for the webhook Must be a reachable HTTPS endpoint.
string
required
Name of the webhook
string
Custom payload template (optional)
string
Encoding type: ‘json’ or ‘form’
string
Custom headers in JSON format (optional)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_CATALOG_ENTITYDelete a single entity. Uses DELETE /api/v2/catalog/entity/{entity_id}.

Input Parameters

string
required
UUID or Entity Ref.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_CATALOG_KINDDelete a single kind. Uses DELETE /api/v2/catalog/kind/{kind_id}.

Input Parameters

string
required
Entity kind name (for example my-job), not the UUID in a kind resource’s id field. Use attributes.name from the kind response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_DASHBOARDDelete a dashboard in Datadog. Permanently removes a dashboard from your organization. This action cannot be undone. Use with caution.

Input Parameters

string
required
Dashboard ID to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_DASHBOARD_LISTDelete a dashboard list. Uses DELETE /api/v1/dashboard/lists/manual/{list_id}. Datadog permission(s): dashboards_write.

Input Parameters

integer
required
ID of the dashboard list to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_DASHBOARD_LIST_ITEMSDelete items from a dashboard list. Uses DELETE /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards. Supply the documented payload in body.

Input Parameters

object
required
Dashboards to delete from the dashboard list.
integer
required
ID of the dashboard list to delete items from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_DASHBOARDSDelete dashboards by ID, atomically: any failure prevents all deletions. Uses DELETE /api/v1/dashboard with dashboard IDs in body.data. Requires the dashboards_write permission.

Input Parameters

object
required
Delete dashboards request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_DERIVED_METRICDelete a derived metric. Uses DELETE /api/v2/metrics/derived-metrics/{metric_name}. Datadog permission(s): metric_tags_write.

Input Parameters

string
required
The name of the metric.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_ESCALATION_POLICYDeletes a Datadog On-Call escalation policy by ID. This action cannot be undone.

Input Parameters

string
required
Unique identifier of the Datadog On-Call escalation policy to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_GLOBAL_VARIABLEDelete a global variable. Uses DELETE /api/v1/synthetics/variables/{variable_id}. Datadog permission(s): synthetics_global_variable_write.

Input Parameters

string
required
The ID of the global variable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_INCIDENT_IMPACTDelete an incident impact. Uses DELETE /api/v2/incidents/{incident_id}/impacts/{impact_id}. Datadog permission(s): incident_write.

Input Parameters

string
required
The UUID of the incident impact.
string
required
The UUID of the incident.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_MONITORDeletes a Datadog monitor permanently. Use with caution as this action cannot be undone.

Input Parameters

boolean
Force delete the monitor (skip confirmation)
integer
required
The ID of the monitor to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_MONITOR_CONFIG_POLICYDelete a monitor configuration policy. Uses DELETE /api/v2/monitor/policy/{policy_id}. Datadog permission(s): monitor_config_policy_write.

Input Parameters

string
required
ID of the monitor configuration policy.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_MONITOR_NOTIFICATION_RULEDelete a monitor notification rule. Uses DELETE /api/v2/monitor/notification_rule/{rule_id}. Datadog permission(s): monitor_config_policy_write.

Input Parameters

string
required
ID of the monitor notification rule to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_NOTEBOOKDelete a notebook. Uses DELETE /api/v1/notebooks/{notebook_id}. Datadog permission(s): notebooks_write.

Input Parameters

integer
required
Unique ID, assigned when you create the notebook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_NOTIFICATION_CHANNELDeletes an On-Call notification channel for a Datadog user. This action cannot be undone.

Input Parameters

string
required
Unique identifier of the user who owns the On-Call notification channel to delete.
string
required
Unique identifier of the On-Call notification channel to delete for the user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_NOTIFICATION_RULEDeletes an On-Call notification rule for a Datadog user. This action cannot be undone.

Input Parameters

string
required
Unique identifier of the On-Call notification rule to permanently delete.
string
required
Unique identifier of the user who owns the On-Call notification rule to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_PRIVATE_LOCATIONDelete a private location. Uses DELETE /api/v1/synthetics/private-locations/{location_id}. Datadog permission(s): synthetics_private_location_write.

Input Parameters

string
required
The ID of the private location.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_PUBLIC_DASHBOARDRevoke a shared dashboard URL. Uses DELETE /api/v1/dashboard/public/{token}. Datadog permission(s): dashboards_public_share, dashboards_embed_share, dashboards_invite_share.

Input Parameters

string
required
The token of the shared dashboard.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_PUBLIC_DASHBOARD_INVITATIONRevoke shared dashboard invitations. Uses DELETE /api/v1/dashboard/public/{token}/invitation. Supply the documented payload in body. Datadog permission(s): dashboards_invite_share.

Input Parameters

object
required
Shared Dashboard Invitation deletion request body.
string
required
The token of the shared dashboard.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_SCHEDULEDeletes a Datadog On-Call schedule by ID. This action cannot be undone.

Input Parameters

string
required
Unique identifier of the Datadog On-Call schedule to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_SCHEDULE_OVERRIDEDelete On-Call schedule override. Uses DELETE /api/v2/on-call/schedules/{schedule_id}/overrides/{override_id}. Datadog permission(s): on_call_respond, on_call_write.

Input Parameters

string
required
The ID of the override.
string
required
The ID of the schedule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_SERVICE_DEFINITIONDelete a single service definition. Uses DELETE /api/v2/services/definitions/{service_name}. Datadog permission(s): apm_service_catalog_write.

Input Parameters

string
required
The name of the service.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_SLODelete an SLO. Uses DELETE /api/v1/slo/{slo_id}. Datadog permission(s): slos_write.

Input Parameters

string
Delete the monitor even if it’s referenced by other resources (for example SLO, composite monitor).
string
required
The ID of the service level objective.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_SLO_TIMEFRAME_IN_BULKDelete thresholds from multiple SLOs using a mapping of SLO IDs to timeframes; deleting all thresholds also deletes the SLO. Uses POST /api/v1/slo/bulk_delete and requires slos_write; the operation may partially succeed, so inspect the returned data and errors.

Input Parameters

object
required
Delete multiple service level objective objects request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_SYNTHETICS_DOWNTIMEDelete a Synthetics downtime. Uses DELETE /api/v2/synthetics/downtimes/{downtime_id}. Datadog permission(s): synthetics_write, synthetics_default_settings_write.

Input Parameters

string
required
The ID of the downtime to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_SYNTHETICS_SUITESBulk delete suites. Uses POST /api/v2/synthetics/suites/bulk-delete. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
The documented request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_SYNTHETICS_TESTSBulk delete tests. Uses POST /api/v2/synthetics/tests/bulk-delete. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
The documented request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_TAG_CONFIGURATIONDelete a tag configuration. Uses DELETE /api/v2/metrics/{metric_name}/tags. Datadog permission(s): metric_tags_write.

Input Parameters

string
required
The name of the metric.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_DELETE_TESTSDelete tests. Uses POST /api/v1/synthetics/tests/delete. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
Public ID list of the Synthetic tests to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_EDIT_GLOBAL_VARIABLEEdit a global variable. Uses PUT /api/v1/synthetics/variables/{variable_id}. Supply the documented payload in body. Datadog permission(s): synthetics_global_variable_write.

Input Parameters

object
required
Details of the global variable to update.
string
required
The ID of the global variable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_EDIT_SYNTHETICS_SUITEEdit a test suite. Uses PUT /api/v2/synthetics/suites/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
New suite details to be saved.
string
required
The public ID of the suite to edit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_ESCALATE_ON_CALL_PAGEEscalate a Datadog On-Call page identified by its page ID. The result indicates whether Datadog accepted the escalation request.

Input Parameters

string
required
The page ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_ESTIMATE_METRICS_OUTPUT_SERIESTag Configuration Cardinality Estimator. Uses GET /api/v2/metrics/{metric_name}/estimate. Datadog permission(s): .

Input Parameters

boolean
Deprecated. This query parameter has no effect on the estimate.
string
required
The name of the metric.
string
Comma-separated list of tag keys that the metric is configured to query with. For example: filter[groups]=app,host.
integer
The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours.
integer
A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.
integer
Deprecated. Number of aggregations has no impact on volume.
boolean
When true, filter[groups] is treated as an exclude list instead of an include list. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_FETCH_UPTIMESFetch uptime for multiple tests. Uses POST /api/v1/synthetics/tests/uptimes. Supply the documented payload in body. Datadog permission(s): synthetics_read.

Input Parameters

object
required
Public ID list of the Synthetic tests and timeframe.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_API_MULTISTEP_SUBTEST_PARENTSGet API multistep tests that include a given subtest, along with their monitor status. Uses GET /api/v2/synthetics/api-multistep/subtests/{public_id}/parents. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the subtest.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_API_MULTISTEP_SUBTESTSGet API tests available as subtests for an API multistep test, excluding the current test. Uses GET /api/v2/synthetics/api-multistep/subtests/{public_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the API multistep test.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_API_TESTGet the detailed configuration of a Synthetic API test by its public ID. Uses GET /api/v1/synthetics/tests/api/{public_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the test to get details from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_API_TEST_LATEST_RESULTSGet an API test’s latest results summaries. Uses GET /api/v1/synthetics/tests/{public_id}/results. Datadog permission(s): synthetics_read.

Input Parameters

integer
Timestamp in milliseconds up to which to query results.
integer
Timestamp in milliseconds from which to start querying results.
array
Locations for which to query results.
string
required
The public ID of the test for which to search results for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_API_TEST_RESULTGet an API test result. Uses GET /api/v1/synthetics/tests/{public_id}/results/{result_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the API test to which the target result belongs.
string
required
The ID of the result to get.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_BROWSER_TESTGet the detailed configuration (including steps) of a Synthetic browser test. Uses GET /api/v1/synthetics/tests/browser/{public_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the test to get details from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_BROWSER_TEST_LATEST_RESULTSGet the last 150 result summaries for a Synthetic browser test. Uses GET /api/v1/synthetics/tests/browser/{public_id}/results. Filter by timestamps in milliseconds and probe locations. Datadog permission(s): synthetics_read.

Input Parameters

integer
Timestamp in milliseconds up to which to query results.
integer
Timestamp in milliseconds from which to start querying results.
array
Locations for which to query results.
string
required
The public ID of the browser test for which to search results for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_BROWSER_TEST_RESULTGet a specific full result from a Synthetic browser test. Uses GET /api/v1/synthetics/tests/browser/{public_id}/results/{result_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the browser test to which the target result belongs.
string
required
The ID of the result to get.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_CUSTOM_EVALUATOR_CONFIGURATIONRetrieve one custom Agent Observability evaluator configuration by name. Datadog currently exposes this read operation as a preview API.

Input Parameters

string
required
Exact name of the custom evaluator configuration to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_DASHBOARDGet a specific dashboard from Datadog. Retrieves detailed information about a dashboard including its widgets, layout, template variables, and metadata.

Input Parameters

string
required
Dashboard ID to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_DASHBOARD_LISTFetch an existing dashboard list definition by ID. Uses GET /api/v1/dashboard/lists/manual/{list_id}. Datadog permission(s): dashboards_read.

Input Parameters

integer
required
ID of the dashboard list to fetch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_DASHBOARD_LIST_ITEMSFetch the dashboard definitions in a dashboard list. Uses GET /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards. Datadog permission(s): dashboards_read.

Input Parameters

integer
required
ID of the dashboard list to get items from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_DERIVED_METRICGet the definition of a derived metric by name. Uses GET /api/v2/metrics/derived-metrics/{metric_name}. Datadog permission(s): metrics_read.

Input Parameters

string
required
The name of the metric.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_DOWNTIMEGet downtime detail by downtime_id. Uses GET /api/v2/downtime/{downtime_id}. Datadog permission(s): monitors_downtime.

Input Parameters

string
Comma-separated list of resource paths for related resources to include in the response. Supported resource paths are created_by and monitor.
string
required
ID of the downtime to fetch.
boolean
If true, include the run_as attribute in the response, which lists the principals allowed to act on behalf of the downtime. Note: This feature is currently in Preview and may not be available for all organizations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_ESCALATION_POLICYRetrieves a Datadog On-Call escalation policy by ID.

Input Parameters

string
required
Unique identifier of the On-Call escalation policy to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_EVENTGet event details by event ID using GET /api/v1/events/{event_id}. Datadog permission(s): events_read.

Input Parameters

string
required
The decimal event ID. Use the provider’s id_str value to avoid 64-bit precision loss; the path receives the same digits.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_EVENT_V2Get the details of an event by event_id. Uses GET /api/v2/events/{event_id}. Datadog permission(s): events_read.

Input Parameters

string
required
The UID of the event.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_GLOBAL_VARIABLEGet a Synthetics global variable by ID using GET /api/v1/synthetics/variables/{variable_id}. The value is not returned when the variable is hidden with the secure property.

Input Parameters

string
required
The ID of the global variable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_HOURLY_USAGEGets hourly Datadog usage records for product families and a UTC hour range.

Input Parameters

integer
Maximum number of records to return, from 1 to 500.
string
Exclusive UTC end hour in ISO-8601 format.
string
Comma-separated product family versions, such as infra_hosts:1.0.0.
string
required
Inclusive UTC start hour in ISO-8601 format, such as 2026-10-01T00.
string
Cursor returned in meta.pagination.next_record_id by the previous page.
string
required
Comma-separated product families to return, or ‘all’.
boolean
Whether to include usage subcategory breakdowns where available.
boolean
Whether to include usage from child organizations.
boolean
Whether to include usage from connected partner accounts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_METRIC_METADATAGet metadata for a specific metric using GET /api/v1/metrics/{metric_name}. Datadog permission(s): metrics_read.

Input Parameters

string
required
Name of the metric for which to get metadata.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_METRIC_TAG_CARDINALITY_DETAILSGet tag key cardinality details for a specific metric. Uses GET /api/v2/metrics/{metric_name}/tag-cardinalities. Datadog permission(s): metrics_read.

Input Parameters

string
required
The name of the metric.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_MOBILE_TESTGet the detailed configuration of a Synthetic mobile test. Uses GET /api/v1/synthetics/tests/mobile/{public_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the test to get details from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_MONITORRetrieves detailed information about a specific Datadog monitor, including its current state, configuration, and any active downtimes.

Input Parameters

integer
required
The ID of the monitor to retrieve Use DATADOG_LIST_MONITORS to discover valid integer IDs if unknown.
array
Filter by group states when retrieving monitor details. Valid values: ‘all’, ‘alert’, ‘warn’, ‘no data’
boolean
Include downtime information in the response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_MONITOR_CONFIG_POLICYGet a monitor configuration policy by policy_id. Uses GET /api/v2/monitor/policy/{policy_id}. Datadog permission(s): monitors_read.

Input Parameters

string
required
ID of the monitor configuration policy.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_MONITOR_NOTIFICATION_RULEGet a monitor notification rule by rule_id. Uses GET /api/v2/monitor/notification_rule/{rule_id}. Optionally include the related created_by resource. Datadog permission(s): monitors_read.

Input Parameters

string
Comma-separated list of resource paths for related resources to include in the response. Supported resource path is created_by.
string
required
ID of the monitor notification rule to fetch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_MONITOR_NOTIFICATION_RULESGet all monitor notification rules. Uses GET /api/v2/monitor/notification_rule. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): monitors_read.

Input Parameters

integer
The page to start paginating from. If page is not specified, the argument defaults to the first page.
string
String for sort order, composed of field and sort order separated by a colon, for example name:asc. Supported sort directions: asc, desc. Supported fields: name, created_at.
string
JSON-encoded filter object. Supported keys: * text: Free-text query matched against rule name, tags, and recipients. * tags: Array of strings. Return rules that have any of these tags. * recipients: Array of strings. Return rules that have any of these recipients.
string
Comma-separated list of resource paths for related resources to include in the response. Supported resource path is created_by.
integer
The number of rules to return per page. If per_page is not specified, the argument defaults to 100.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_NOTEBOOKGet a notebook using its notebook ID. Uses GET /api/v1/notebooks/{notebook_id}. Datadog permission(s): notebooks_read.

Input Parameters

integer
required
Unique ID, assigned when you create the notebook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_NOTIFICATION_CHANNELRetrieves an On-Call notification channel for a user by ID.

Input Parameters

string
required
Unique identifier of the user whose On-Call notification channel you want to retrieve.
string
required
Unique identifier of the On-Call notification channel to retrieve for the user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_NOTIFICATION_RULERetrieves an On-Call notification rule for a user by ID.

Input Parameters

string
required
Unique identifier of the On-Call notification rule to retrieve for the user.
string
required
Unique identifier of the user whose On-Call notification rule should be fetched.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_ON_DEMAND_CONCURRENCY_CAPGet the on-demand concurrency cap. Uses GET /api/v2/synthetics/settings/on_demand_concurrency_cap. Datadog permission(s): billing_read.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_PRIVATE_LOCATIONGet a Synthetic private location by its ID. Uses GET /api/v1/synthetics/private-locations/{location_id}. Datadog permission(s): synthetics_private_location_read.

Input Parameters

string
required
The ID of the private location.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_PUBLIC_DASHBOARDFetch sharing metadata for an existing shared dashboard by its sharing token. Uses GET /api/v1/dashboard/public/{token}. Datadog permission(s): dashboards_read.

Input Parameters

string
required
The token of the shared dashboard. Generated when a dashboard is shared.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_PUBLIC_DASHBOARD_INVITATIONSGet all invitations for a shared dashboard. Uses GET /api/v1/dashboard/public/{token}/invitation. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): dashboards_invite_share.

Input Parameters

string
required
Token of the shared dashboard for which to fetch invitations.
integer
The number of records to return in a single request.
integer
The page to access (base 0).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SCHEDULERetrieves a Datadog On-Call schedule by ID.

Input Parameters

string
required
Unique identifier of the On-Call schedule to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SCHEDULED_ON_CALL_USERGets the currently scheduled on-call user for a Datadog On-Call schedule using a deprecated Datadog endpoint.

Input Parameters

string
required
Unique identifier of the On-Call schedule whose currently scheduled on-call user you want to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SCHEDULE_ON_CALL_RESPONDERSGet on-call responders for a schedule. Uses GET /api/v2/on-call/schedules/{schedule_id}/responders. Filter by position and timestamp, and optionally include related schedule, responders, shifts, and users. Datadog permission(s): on_call_read.

Input Parameters

string
Comma-separated list of included relationships to be returned. Allowed values: schedule, responders, responders.shifts, responders.shifts.user.
string
required
The ID of the schedule.
string
Retrieves the on-call responders at the given timestamp in RFC3339 format (for example, 2025-05-07T02:53:01Z or 2025-05-07T02:53:01+00:00). If you use a time zone offset with +, URL-encode the + as %2B. Defaults to the current time if omitted.
string
Comma-separated list of positions to retrieve. Allowed values: previous, current, next. Defaults to current if omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SERVICE_DEFINITIONGet a single service definition by service name, optionally selecting the response schema version. Uses GET /api/v2/services/definitions/{service_name}. Datadog permission(s): apm_service_catalog_read.

Input Parameters

string
required
The name of the service.
string ("v1" | "v2" | "v2.1" | "v2.2")
Schema versions

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SERVICE_DEPENDENCIESGet service dependency mapping from Datadog APM for a specific service, with upstream and downstream lists. Dependency entries may include call rates, error rates, and latency metrics; entries in a combined dependency list are classified as downstream unless explicitly marked upstream.

Input Parameters

string
Environment to filter by Strongly recommended: omitting this aggregates data across all environments, producing noisy results that obscure meaningful dependency relationships.
string
required
The service name to get dependencies for
integer
End time as UNIX timestamp (seconds)
integer
Start time as UNIX timestamp (seconds)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SLOGet a service level objective’s details by ID. Uses GET /api/v1/slo/{slo_id}. Optionally include IDs of SLO monitors referencing this SLO. Datadog permission(s): slos_read.

Input Parameters

string
required
The ID of the service level objective object.
boolean
Get the IDs of SLO monitors that reference this SLO.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SLO_CORRECTIONSGet corrections applied to an SLO. Uses GET /api/v1/slo/{slo_id}/corrections. Datadog permission(s): slos_read.

Input Parameters

string
required
The ID of the service level objective object.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SLO_HISTORYGet an SLO’s history for an epoch-second time window, for metric, monitor, or time-slice SLOs. Uses GET /api/v1/slo/{slo_id}/history and requires the slos_read Datadog permission.

Input Parameters

integer
required
The to timestamp for the query window in epoch seconds.
string
required
The ID of the service level objective object.
number
The SLO target. If target is passed in, the response will include the remaining error budget and a timeframe value of custom.
integer
required
The from timestamp for the query window in epoch seconds.
boolean
Defaults to true. If any SLO corrections are applied and this parameter is set to false, then the corrections will not be applied and the SLI values will not be affected.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_BROWSER_TEST_RESULTGet a specific full result from a given Synthetic browser test. Uses GET /api/v2/synthetics/tests/browser/{public_id}/results/{result_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
The event ID used to look up the result in the event store.
string
required
The public ID of the Synthetic browser test to which the target result belongs.
string
required
The ID of the result to get.
integer
Timestamp in seconds to look up the result.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_CI_BATCHGet updated details of a batch. Uses GET /api/v1/synthetics/ci/batch/{batch_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The ID of the batch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_DEFAULT_LOCATIONSGet the default locations settings. Uses GET /api/v1/synthetics/settings/default_locations. Returns the list of default Synthetic Monitoring location identifiers. Datadog permission(s): synthetics_default_settings_read.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_DOWNTIMEGet a Synthetics downtime by its ID. Uses GET /api/v2/synthetics/downtimes/{downtime_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The ID of the downtime to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_FAST_TEST_RESULTRead a newly triggered Synthetic result by result ID, without needing a test public ID. Results can be transiently unavailable; retry with a fresh result ID. Uses GET /api/v2/synthetics/tests/fast/{id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The UUID of the fast test to retrieve the result for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_LOCATIONSTool to retrieve all available public and private locations for Synthetic tests in Datadog. Use when you need a list of location identifiers for creating or managing synthetic tests.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_NETWORK_TESTGet a Network Path test by its public ID. Uses GET /api/v2/synthetics/tests/network/{public_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the Network Path test to get details from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_SUITEGet a Synthetics suite by its public ID. Uses GET /api/v2/synthetics/suites/{public_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the suite to get details from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_TEST_RESULTGet a specific full result from a given Synthetic test. Uses GET /api/v2/synthetics/tests/{public_id}/results/{result_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
The event ID used to look up the result in the event store.
string
required
The public ID of the Synthetic test to which the target result belongs.
string
required
The ID of the result to get.
integer
Timestamp in seconds to look up the result.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_SYNTHETICS_TEST_VERSIONGet a specific version of a Synthetic test by its version number. Uses GET /api/v2/synthetics/tests/{public_id}/version_history/{version_number}. Set only_check_existence to return an empty object if the version exists, or 404 if not. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the Synthetic test.
integer
required
The version number to retrieve.
boolean
If true, only check whether the version exists without returning its full payload. Returns an empty object if the version exists, or 404 if not.
boolean
If true, include change metadata in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_TAGSRetrieves tags associated with a specific host in Datadog, optionally filtered by tag source. Useful for understanding host metadata and organizing infrastructure.

Input Parameters

string
Source of tags to retrieve (e.g., ‘users’, ‘chef’, ‘puppet’)
string
required
Name of the host to get tags from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_TEAM_ON_CALL_USERSGets the current on-call users for a Datadog On-Call team.

Input Parameters

string
required
Unique identifier of the team whose current on-call users you want to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_TEAM_ROUTING_RULESGets the Datadog On-Call routing rules configured for a team.

Input Parameters

string
required
Unique identifier of the On-Call team whose routing rules you want to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_TESTGet the detailed configuration associated with a Synthetic test. Uses GET /api/v1/synthetics/tests/{public_id}. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the test to get details from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_TEST_FILE_DOWNLOAD_URLGet a presigned URL for downloading a test file. Uses POST /api/v2/synthetics/tests/{public_id}/files/download. Supply the documented payload in body. Datadog permission(s): synthetics_read.

Input Parameters

object
required
The documented request body.
string
required
The public ID of the Synthetic test.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_TEST_FILE_MULTIPART_PRESIGNED_URLSInitiate a multipart test-file upload and return a presigned URL per part. Upload the parts, then complete or abort the session; obtaining URLs creates an upload session. Uses POST /api/v2/synthetics/tests/{public_id}/files/multipart-presigned-urls. Supply the documented payload in body. Datadog permission(s): synthetics_write, synthetics_create_edit_trigger.

Input Parameters

object
required
The documented request body.
string
required
The public ID of the Synthetic test.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_TEST_PARENT_SUITESGet parent suites and their status for a Synthetic test. Uses GET /api/v2/synthetics/tests/{public_id}/parent-suites. Datadog permission(s): synthetics_read.

Input Parameters

string
required
The public ID of the Synthetic test.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_TRACE_BY_IDSearch Datadog APM span events for a trace ID within a time window, returning details for up to 1,000 spans on a single page. Use a narrow time window when the approximate trace time is known. DEPRECATED: Use DATADOG_SEARCH_TRACES instead.

Input Parameters

string
End time for the search window. Supports ISO8601, date math (e.g., ‘now’), or timestamps in milliseconds. Defaults to current time.
string
required
The unique trace ID to retrieve
string
Start time for the search window. Supports ISO8601, date math (e.g., ‘now-1h’, ‘now-15d’), or timestamps in milliseconds. Defaults to 15 days ago.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_USAGE_SUMMARYRetrieves usage summary information from Datadog including API calls, hosts, containers, and other billable usage metrics. Useful for cost monitoring and usage analysis. Months with no activity return empty payloads on success; absent data is expected, not an error.

Input Parameters

string
End month in YYYY-MM format. If not provided, uses start_month
string
required
Start month in YYYY-MM format
boolean
Include organization details in the response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_USERRetrieve one Datadog organization user by ID, including related resources.

Input Parameters

string
required
ID of the Datadog user to retrieve. Use DATADOG_LIST_USERS to discover it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_GET_WEBHOOKS_INTEGRATIONGet the content of a webhook integration by name. Uses GET /api/v1/integration/webhooks/configuration/webhooks/{webhook_name}. Datadog permission(s): integrations_read.

Input Parameters

string
required
The name of the webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_ACTIVE_METRIC_CONFIGURATIONSList tags and aggregations actively queried for a metric on dashboards, notebooks, monitors, the Metrics Explorer, and the API. Uses GET /api/v2/metrics/{metric_name}/active-configurations. Datadog permission(s): metrics_read.

Input Parameters

string
required
The name of the metric.
integer
The number of seconds of look back (from now). Default value is 604,800 (1 week), minimum value is 7200 (2 hours), maximum value is 2,630,000 (1 month).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_ALL_TAGSList Datadog host tags, optionally filtered by source. Tags help organize and filter infrastructure.

Input Parameters

string
Filter tags by source (e.g., ‘chef’, ‘puppet’, ‘users’, ‘datadog’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_API_KEYSList a page of Datadog API keys for security auditing, access management, and key rotation planning. Returns key metadata and pagination information; handle the output securely.

Input Parameters

string ("created_at" | "last4" | "modified_at" | "name")
Sort field.
integer
Number of API keys to return per page (default 20, max 1000)
integer
Page number to retrieve (0-indexed)
string
ISO timestamp to filter keys created before this time
string
ISO timestamp to filter keys modified before this time
string
ISO timestamp to filter keys created after this time
string
ISO timestamp to filter keys modified after this time

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_APM_SERVICESList Datadog APM services, optionally filtering by environment. Use ’*’ to include services across environments.

Input Parameters

string
Environment filter (e.g., ‘production’, ‘staging’). Use ’*’ to return services across all environments.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_AWS_ACCOUNTSList all AWS integrations. Uses GET /api/v2/integration/aws/accounts. Optionally filter by AWS account ID; otherwise returns all accounts. Datadog permission(s): aws_configuration_read.

Input Parameters

string
Optional query parameter to filter accounts by AWS Account ID. If not provided, all accounts are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_AWS_INTEGRATIONList AWS integrations in Datadog. Retrieves all configured AWS account integrations, showing which AWS accounts are monitored by Datadog and their configuration settings. Useful for cloud infrastructure management and ensuring comprehensive monitoring coverage.

Input Parameters

string
Filter by specific AWS IAM role name
string
Filter by specific AWS account ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_CATALOG_ENTITYGet a list of entities. Uses GET /api/v2/catalog/entity. Returns one page; pass the documented pagination fields to continue.

Input Parameters

string ("schema" | "raw_schema" | "oncall" | "incident" | "relation")
Supported include types.
string
Filter entities by UUID.
string
Filter entities by reference
integer
Maximum number of entities in the response.
string
Filter entities by kind.
string
Filter entities by name.
integer
Specific offset to use as the beginning of the returned page.
string
Filter entities by owner.
boolean
If true, includes discovered services from APM and USM that do not have entity definitions.
string ("RelationTypeOwns" | "RelationTypeOwnedBy" | "RelationTypeDependsOn" | "RelationTypeDependencyOf" | "RelationTypePartsOf" | "RelationTypeHasPart" | "RelationTypeOtherOwns" | "RelationTypeOtherOwnedBy" | "RelationTypeImplementedBy" | "RelationTypeImplements")
Supported relation types.
string
Filter entities by excluding snapshotted entities.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_CATALOG_KINDGet a list of entity kinds. Uses GET /api/v2/catalog/kind. Returns one page; pass the documented pagination fields to continue.

Input Parameters

string
Filter entities by UUID.
integer
Maximum number of kinds in the response.
string
Filter entities by name.
integer
Specific offset to use as the beginning of the returned page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_CATALOG_RELATIONGet a list of entity relations. Uses GET /api/v2/catalog/relation. Returns one page; pass the documented pagination fields to continue.

Input Parameters

string ("entity" | "schema")
Supported include types for relations.
integer
Maximum number of relations in the response.
string ("RelationTypeOwns" | "RelationTypeOwnedBy" | "RelationTypeDependsOn" | "RelationTypeDependencyOf" | "RelationTypePartsOf" | "RelationTypeHasPart" | "RelationTypeOtherOwns" | "RelationTypeOtherOwnedBy" | "RelationTypeImplementedBy" | "RelationTypeImplements")
Supported relation types.
integer
Specific offset to use as the beginning of the returned page.
string
Filter relations by the reference of the second entity in the relation.
string
Filter relations by the reference of the first entity in the relation.
boolean
If true, includes relationships discovered by APM and USM.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_DASHBOARD_LISTSFetch all existing dashboard list definitions. Uses GET /api/v1/dashboard/lists/manual without pagination parameters. Required Datadog permission: dashboards_read.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_DASHBOARDSLists Datadog dashboards with basic information, with optional shared and deleted filters and pagination. Useful for dashboard management and getting an overview of available dashboards.

Input Parameters

integer
Maximum number of dashboards to return (for pagination)
integer
Offset for pagination; skip this many dashboards before returning results
boolean
Filter dashboards by shared status
boolean
Include deleted dashboards in the results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_DOWNTIMESGet all downtimes. Uses GET /api/v2/downtime. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): monitors_downtime.

Input Parameters

string
Comma-separated list of resource paths for related resources to include in the response. Supported resource paths are created_by and monitor.
integer
Maximum number of downtimes in the response.
integer
Specific offset to use as the beginning of the returned page.
boolean
Only return downtimes that are active when the request is made.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_EVENTSLists a page of Datadog events within a specified time range, with optional filters including tags, sources, and priority. The returned total count is the number of events in that page, not a count across all pages.

Input Parameters

integer
required
End time as UNIX timestamp
integer
Page number for pagination
array
Filter by tags
integer
required
Start time as UNIX timestamp
string
Filter by event sources (comma-separated)
string ("normal" | "low")
Filter by event priority.
boolean
Get unaggregated events (default: false)
boolean
Exclude aggregated events

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_EVENTS_V2Get a list of events. Uses GET /api/v2/events. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): events_read.

Input Parameters

string ("timestamp" | "-timestamp")
The sort parameters when querying events.
string
Maximum timestamp for requested events, in milliseconds.
integer
Maximum number of events in the response.
string
Minimum timestamp for requested events, in milliseconds.
string
List following results with a cursor provided in the previous query.
string
Search query following events syntax.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_GLOBAL_VARIABLESGet all Synthetic global variables. Uses GET /api/v1/synthetics/variables. Requires either synthetics_global_variable_read or apm_api_catalog_read permission.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_HOSTSLists a page of hosts in your Datadog infrastructure, with available metrics, tags, and status. Supports filtering, sorting, and pagination for infrastructure monitoring and management.

Input Parameters

integer
Number of hosts to return (max 1000)
integer
Starting position for pagination
string
Filter hosts by tags or attributes
string ("asc" | "desc")
Sort direction.
string ("status" | "name" | "cpu" | "iowait" | "load")
Field to sort by.
integer
Start time as UNIX timestamp for host activity
boolean
Include hosts metadata in response
boolean
Include data for muted hosts

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_INCIDENT_IMPACTSList all impacts for an incident. Uses GET /api/v2/incidents/{incident_id}/impacts. Optionally include related incident resources. Datadog permission(s): incident_read.

Input Parameters

array
Specifies which related resources should be included in the response.
string
required
The UUID of the incident.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_INCIDENTSList a page of incidents from Datadog, with optional filtering and sorting. The returned total_count is the number of incidents in that page, not the total across all pages.

Input Parameters

string ("public_id" | "-public_id")
Sort order for incidents by public ID.
string
Related resources to include (e.g., ‘users,attachments’)
integer
Number of incidents per page (1-100, default: 25)
integer
Page offset for pagination (default: 0)
string
Filter query for incidents (e.g., ‘state:active’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_LOG_INDEXESTool to retrieve a list of all log indexes configured in Datadog, including their names and configurations. Use before DATADOG_SEARCH_LOGS to identify the correct index name; searching without specifying the right index can hide valid logs and increase usage costs across high-volume indexes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_LOGSSearch logs (GET). Uses GET /api/v2/logs/events. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): logs_read_data.

Input Parameters

string ("timestamp" | "-timestamp")
Sort parameters when querying logs.
string
Maximum timestamp for requested logs.
integer
Maximum number of logs in the response.
string
Minimum timestamp for requested logs.
string
List following results with a cursor provided in the previous query.
string
Search query following logs syntax.
array
For customers with multiple indexes, the indexes to search. Defaults to ’*’ which means all indexes
string ("indexes" | "online-archives" | "flex")
Specifies storage type as indexes, online-archives or flex

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_METRICSDiscover metric names by listing actively reporting metrics since a given timestamp. Use when you need to find what metrics exist before querying timeseries data with DATADOG_QUERY_METRICS.

Input Parameters

string
Hostname for filtering the list of metrics returned. If set, metrics retrieved are those with the corresponding hostname tag.
string
Filter metrics that have been submitted with the given tags. Supports boolean and wildcard expressions (e.g., ‘env:prod AND service:api’). Cannot be combined with other filters.
integer
required
Seconds since Unix epoch. Specifies the starting point for listing actively reporting metrics.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_METRIC_TAG_CONFIGURATIONSGet a list of metrics using GET /api/v2/metrics, with optional pagination; when enabled, each call returns one page and pagination fields can be used to continue. Datadog permission(s): metrics_read.

Input Parameters

string
Sort results by metric volume. Prefix a key with - for descending order. Supported keys: metric_volumes.indexed_volume, metric_volumes.ingested_volume, metric_volumes.indexed_volume_delta, metric_volumes.ingested_volume_delta. Requires a paginated request (page[size] or page[cursor]).
string
Include related resources in the response. Set to metric_volumes to include indexed and ingested volume counts for each metric.
integer
Maximum number of results per page. Send page[size] on the first request to opt in to pagination. On subsequent requests, send page[cursor] set to the value of meta.pagination.next_cursor from the previous response. To retain a custom page size, include page[size] on every request. The default value is 10000, the maximum value is 10000, and the minimum value is 1.
string
Only return metrics that were submitted with tags matching this expression. You can use AND, OR, IN, and wildcards. For example: filter[tags]=env IN (staging,test) AND service:web*.
string
Cursor for pagination. Use page[size] to opt-in to pagination and get the first page; for subsequent pages, use the value from meta.pagination.next_cursor in the response. Pagination is complete when next_cursor is null.
boolean
Only return metrics that have been queried (true) or not queried (false) in the look back window. Set the window with filter[queried][window][seconds]; if omitted, a default window is used.
integer
Only return metrics that have been actively reporting in this window. The default value is 3,600 seconds (1 hour), the maximum value is 5,184,000 seconds (60 days), and the minimum value is 0. With 0, the API returns only metrics that reported in the last few minutes.
boolean
Only return custom metrics that have been configured (true) or not configured (false) with Metrics Without Limits.
string ("non_distribution" | "distribution" | "exponential_histogram" | "explicit_histogram")
The metric’s type category.
Only return metrics that are used in at least one dashboard, monitor, notebook, or SLO.
boolean
Only return metrics that are eligible (true) or ineligible (false) for configuration with Metrics Without Limits.
string
Only return metrics that have the given tag key(s) in their Metrics Without Limits configuration (included or excluded).
boolean
Only return distribution metrics that have percentile aggregations enabled (true) or disabled (false).
integer
The look-back window for filter[queried], in seconds. You must also set filter[queried], or the request returns a 400 error. The default value is 2,592,000 seconds (30 days), the maximum value is 15,552,000 seconds (180 days), and the minimum value is 0. With 0, the window ends now, so filter[queried]=true returns almost no metrics and filter[queried]=false returns all metrics. For example: filter[queried]=true&filter[queried][window][seconds]=604800.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_METRIC_TAGSList indexed and ingested tags observed for one Datadog metric.

Input Parameters

integer
Maximum number of tags to return, from 1 through 1000000.
string
Comma-separated tags that data points must contain, such as env:staging,host:123.
string
required
Name of the metric whose observed tags are returned.
string
Text used to match tag keys or values.
boolean
Whether Datadog may return partial results when all tags are unavailable.
integer
Lookback window in seconds. Datadog requires at least 14400 seconds.
boolean
Whether to include tag values in the returned tags.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_MONITOR_CONFIG_POLICIESGet all monitor configuration policies. Uses GET /api/v2/monitor/policy. Datadog permission(s): monitors_read.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_MONITOR_DOWNTIMESGet active downtimes for a monitor. Uses GET /api/v2/monitor/{monitor_id}/downtime_matches. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): monitors_downtime.

Input Parameters

integer
required
The id of the monitor.
integer
Maximum number of downtimes in the response.
integer
Specific offset to use as the beginning of the returned page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_MONITORSList monitor details for your organization, with name and tag filters, group-state options, and pagination. The returned total_count is the number of monitors in the response, not an independent organization-wide total.

Input Parameters

string
Filter monitors by name (substring match)
integer
The page to start paginating from. If this argument is not specified, the request returns all monitors without pagination. Both page and page_size must be set together to enable pagination; omitting either returns all monitors unpaginated. Iterate through pages (starting at 0) until a page returns fewer than page_size results to ensure all monitors are retrieved.
array
A comma separated list indicating what tags, if any, should be used to filter the list of monitors by scope. For example host:host0.
integer
Monitor ID offset for pagination
integer
The number of monitors to return per page. If the page argument is not specified, the default behavior returns all monitors without pagination. Page size is capped at 100.
array
When specified, shows additional information about the group states. Choose one or more from Alert, Warn, or No Data.
array
A comma separated list indicating what service and/or custom tags, if any, should be used to filter the list of monitors. Tags created in the Datadog UI automatically have the service key prepended. For example service:my-app.
boolean
If this argument is set to true, then the returned data includes all current downtimes for the monitor.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_NOTEBOOKSGet all notebooks. Uses GET /api/v1/notebooks. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): notebooks_read.

Input Parameters

string
If type is provided, returns only notebooks with that metadata type. Default does not have type filtering.
integer
The number of notebooks to be returned.
string
Return only notebooks with query string in notebook name or author handle.
integer
The index of the first notebook you want returned.
string
Sort by direction asc or desc.
string
Sort by field modified, name, or created.
boolean
True value returns only template notebooks. Default is false (returns only non-template notebooks).
string
Return notebooks created by the given author_handle.
boolean
Value of false excludes the cells and global time for each notebook.
string
Return notebooks not created by the given author_handle.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_NOTIFICATION_CHANNELSLists the On-Call notification channels configured for a Datadog user.

Input Parameters

string
required
Unique identifier of the Datadog user whose On-Call notification channels to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_NOTIFICATION_RULESLists the On-Call notification rules configured for a Datadog user.

Input Parameters

string
required
Unique identifier of the Datadog user whose On-Call notification rules to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_ON_CALL_SCHEDULESList On-Call schedules. Uses GET /api/v2/on-call/schedules. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): on_call_read.

Input Parameters

string
Comma-separated list of included relationships to be returned. Allowed value: teams.
integer
Number of items to return per page. The maximum allowed value is 100.
integer
Specific page number to return.
string
Search query to filter schedules. Supports free-text search on schedule name (case-insensitive, * wildcards), and structured filters such as team.id:<uuid> and user.id:<uuid> (multiple values can be combined with OR, e.g. user.id:(<uuid> OR <uuid>)).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_ORGANIZATIONSList top-level Datadog organization metadata visible to the account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_ROLESList roles from Datadog organization. Roles define sets of permissions that control what users can do within your Datadog organization.

Input Parameters

string
Sort field (name, created_at, user_count)
integer
Number of roles per page (1-100, default: 10)
string
Filter roles by name (partial match)
integer
Page number for pagination (default: 0)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SCHEDULE_OVERRIDESList On-Call schedule overrides. Uses GET /api/v2/on-call/schedules/{schedule_id}/overrides. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): on_call_read.

Input Parameters

string
Comma-separated list of related resources to include in the response. Allowed values: user, overridden_user, user.color.
integer
Number of overrides to return per page. The maximum allowed value is 50.
string
required
End of the time range to retrieve overrides for, in RFC3339 format (for example, 2025-05-07T02:53:01Z or 2025-05-07T02:53:01+00:00). If you use a time zone offset with +, URL-encode the + as %2B. The time range cannot exceed 45 days.
integer
Specific page number to return.
string
required
The ID of the schedule.
string
required
Start of the time range to retrieve overrides for, in RFC3339 format (for example, 2025-05-07T02:53:01Z or 2025-05-07T02:53:01+00:00). If you use a time zone offset with +, URL-encode the + as %2B.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SERVICE_CHECKSLists service checks from Datadog. Service checks are status checks that track the health of your services and infrastructure components.

Input Parameters

integer
End time as UNIX timestamp
array
Filter by tags
string
Filter by service check name
integer
Start time as UNIX timestamp
string ("ok" | "warning" | "critical" | "unknown")
Filter by service check status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SERVICE_DEFINITIONSPage through service definitions in the Datadog Service Catalog.

Input Parameters

integer
Number of service definitions to return; use at most 100 (provider default: 10).
integer
Zero-based page number to return (provider default: 0).
string ("v1" | "v2" | "v2.1" | "v2.2")
Service definition schema version desired in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SL_OSList Service Level Objectives (SLOs) from Datadog. Service Level Objectives help you track the reliability and performance of your services by setting measurable targets for key metrics.

Input Parameters

string
Filter SLOs by tags using a comma-separated list (e.g., ‘env:prod,team:backend’)
integer
Maximum number of SLOs to return (1-1000, default: 25)
string
Search query to filter SLOs by name or description
integer
Number of SLOs to skip for pagination (default: 0)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SPAN_METRICSList configured Datadog span-based metrics and their definitions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SPANSSearch spans. Uses POST /api/v2/spans/events/search. Supply the documented payload in body.

Input Parameters

object
required
The documented request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SYNTHETICSList Synthetics tests from Datadog, with optional tag and location filters and pagination parameters. The returned total_count is the number of tests in the response, not an independent total across all matching tests.

Input Parameters

string
Filter tests by tags using a comma-separated list (e.g., ‘env:prod,team:frontend’)
integer
Maximum number of tests to return (1-200, default: 50)
integer
Zero-based page number for pagination (default: 0). Page 0 returns first page, page 1 returns second page, etc.
string
Filter tests by locations using a comma-separated list

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SYNTHETICS_BROWSER_TEST_LATEST_RESULTSGet a browser test’s latest result summaries using GET /api/v2/synthetics/tests/browser/{public_id}/results. Filter by timestamps, status, run type, locations, or device IDs; Datadog permission: synthetics_read.

Input Parameters

integer
Timestamp in milliseconds up to which to query results.
string ("passed" | "failed" | "no_data")
Status of a Synthetic test result.
integer
Timestamp in milliseconds from which to start querying results.
string ("scheduled" | "fast" | "ci" | "triggered")
The type of run for a Synthetic test result.
array
Locations for which to query results.
array
Device IDs for which to query results.
string
required
The public ID of the Synthetic browser test for which to search results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SYNTHETICS_DOWNTIMESList Synthetics downtimes for your organization. Uses GET /api/v2/synthetics/downtimes. Optionally filter by test public IDs or active status. Datadog permission(s): synthetics_read.

Input Parameters

string
If set to true, return only downtimes that are currently active.
string
Comma-separated list of Synthetics test public IDs to filter downtimes by.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SYNTHETICS_TEST_LATEST_RESULTSGet the latest result summaries for a Synthetic test. Uses GET /api/v2/synthetics/tests/{public_id}/results. Filter by time range, status, run type, location, or device. Datadog permission(s): synthetics_read.

Input Parameters

integer
Timestamp in milliseconds up to which to query results.
string ("passed" | "failed" | "no_data")
Status of a Synthetic test result.
integer
Timestamp in milliseconds from which to start querying results.
string ("scheduled" | "fast" | "ci" | "triggered")
The type of run for a Synthetic test result.
array
Locations for which to query results.
array
Device IDs for which to query results.
string
required
The public ID of the Synthetic test for which to search results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_SYNTHETICS_TEST_VERSIONSGet version history of a test. Uses GET /api/v2/synthetics/tests/{public_id}/version_history. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): synthetics_read.

Input Parameters

integer
Maximum number of version records to return per page.
string
required
The public ID of the Synthetic test.
integer
The version number of the last item from the previous page. Omit to get the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_TAG_CONFIGURATION_BY_NAMEReturn the tag configuration for a metric name using GET /api/v2/metrics/{metric_name}/tags. A 404 means no tag configuration exists, not that the metric is missing. Datadog permission(s): metrics_read.

Input Parameters

string
required
The name of the metric.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_USERSList users from Datadog organization. User management allows you to see team members, their roles, and access levels within your Datadog organization.

Input Parameters

string
Sort field (name, email, status, created_at)
string
Sort direction (asc or desc)
integer
Number of users per page (1-1000, default: 50)
integer
Page number for pagination (default: 0)
string
Filter by user status (Active, Pending, Disabled)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_VOLUMES_BY_METRIC_NAMEView hourly average cardinality for a metric over a look back period. Metric Name Pricing customers receive total point volume instead. Uses GET /api/v2/metrics/{metric_name}/volumes. The optional window[seconds] defaults to 3,600 seconds; the documented maximum is 2,592,000 seconds.

Input Parameters

string
required
The name of the metric.
integer
The number of seconds of look back (from now). Default value is 3,600 (1 hour), maximum value is 2,592,000 (1 month).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_LIST_WEBHOOKSList webhooks from Datadog for notification integrations. The returned total count is the number of webhook entries in the response, not necessarily the total configured in the organization.

Input Parameters

integer
Maximum number of webhooks to return (1-100, default: 50)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_MUTE_MONITORMute a monitor in Datadog. Temporarily silences alerts from a monitor, which is useful during maintenance windows, deployments, or when investigating known issues to prevent alert fatigue.

Input Parameters

integer
POSIX timestamp for when the mute should expire (optional, if not specified the monitor remains muted until manually unmuted)
boolean
Whether to override existing mute settings
integer
required
The ID of the monitor to mute

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_PATCH_GLOBAL_VARIABLEPatch a global variable. Uses PATCH /api/v2/synthetics/variables/{variable_id}/jsonpatch. Supply the documented payload in body. Datadog permission(s): synthetics_global_variable_write.

Input Parameters

object
required
JSON Patch document with operations to apply.
string
required
The ID of the global variable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_PATCH_TESTPatch a Synthetic test. Uses PATCH /api/v1/synthetics/tests/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
JSON Patch compliant list of operations
string
required
The public ID of the test to patch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_PATCH_TEST_SUITEPatch a test suite. Uses PATCH /api/v2/synthetics/suites/{public_id}/jsonpatch. Supply the documented payload in body. Datadog permission(s): synthetics_write, synthetics_create_edit_trigger.

Input Parameters

object
required
JSON Patch document with operations to apply.
string
required
The public ID of the Synthetic test suite to patch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_POLL_SYNTHETICS_TEST_RESULTSPoll for test results given a JSON-encoded array of result IDs, typically after triggering tests with CI/CD. Uses GET /api/v2/synthetics/tests/poll_results. Datadog permission(s): synthetics_read.

Input Parameters

string
required
A JSON-encoded array of result IDs to poll for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_PREVIEW_CATALOG_ENTITIESPreview catalog entities. Uses POST /api/v2/catalog/entity/preview.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_QUERY_METRICSQueries Datadog metrics and returns time series data for a time range of up to 365 days. Useful for retrieving historical metric data, creating custom dashboards, or building reports.

Input Parameters

string
required
Datadog metrics query string Broad tag filters (e.g., {*}) can return high-cardinality payloads; overly restrictive tag combinations can silently return empty series even when data exists.
integer
required
End time as UNIX timestamp. Note: Time range cannot exceed 1 year. Must be UTC-based seconds (not milliseconds); non-UTC or millisecond values silently return empty series.
integer
required
Start time as UNIX timestamp. Note: Time range cannot exceed 1 year. Must be UTC-based seconds (not milliseconds); non-UTC or millisecond values silently return empty series.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_QUERY_SCALAR_DATARun Datadog formula queries and return aggregated scalar columns.

Input Parameters

array
required
Typed scalar queries selected by data_source.
array
Formulas over named queries, with optional result limits.
integer
required
Exclusive end of the query window as Unix epoch milliseconds.
integer
required
Inclusive start of the query window as Unix epoch milliseconds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_QUERY_TIMESERIES_DATARuns Datadog multi-product formula queries and returns aligned timeseries values.

Input Parameters

array
required
Typed Datadog timeseries queries selected by data_source.
array
Formula expressions evaluated over named queries.
integer
Requested rollup interval in milliseconds. Datadog may increase this value.
integer
required
Exclusive end of the query window as a Unix epoch timestamp in milliseconds.
integer
required
Inclusive start of the query window as a Unix epoch timestamp in milliseconds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_REMOVE_TEST_FROM_SYNTHETICS_DOWNTIMERemove a test from a Synthetics downtime. Uses DELETE /api/v2/synthetics/downtimes/{downtime_id}/tests/{test_id}. Datadog permission(s): synthetics_write.

Input Parameters

string
required
The public ID of the Synthetics test to disassociate from the downtime.
string
required
The ID of the downtime.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_RESOLVE_ON_CALL_PAGEResolve an On-Call page by ID using POST /api/v2/on-call/pages/{page_id}/resolve. The request uses navy.oncall.datadoghq.com unless an On-Call host is explicitly configured.

Input Parameters

string
required
The page ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_RESTORE_DASHBOARDSRestore deleted dashboards. Uses PATCH /api/v1/dashboard. Supply the documented payload in body. Datadog permission(s): dashboards_write.

Input Parameters

object
required
Restore dashboards request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SCHEDULE_DOWNTIMESchedule a Datadog v2 downtime to suppress monitor alerts, once or on an RRULE recurrence. Returns a UUID string ID, unlike the v1 Create downtime action.

Input Parameters

object
required
JSON:API downtime resource to create.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_AUDIT_LOGSSearch Datadog Audit Trail events with filters and cursor pagination.

Input Parameters

string ("timestamp" | "-timestamp")
Order events by ascending or descending timestamp.
integer
Maximum number of audit events to return; must not exceed 1000.
string
Datadog Audit Trail search query.
string
Cursor from meta.page.after in the previous response.
string
End time as date math or a millisecond timestamp string.
string
Timezone used for date math; mutually exclusive with time_offset.
string
Start time as date math or a millisecond timestamp string.
integer
UTC offset in seconds; mutually exclusive with timezone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_EVENTSSearches Datadog Event Management events with filters and pagination.

Input Parameters

string ("timestamp" | "-timestamp")
Sort events by timestamp in ascending or descending order.
integer
Maximum number of events to return; must not exceed 1000.
string
Datadog event search query.
string
Cursor from meta.page.after in a previous response.
string
End time as date math or a millisecond timestamp string.
string
Timezone used for date math; mutually exclusive with time_offset.
string
Start time as date math or a millisecond timestamp string.
integer
UTC offset in seconds; mutually exclusive with timezone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_LOGSSearches Datadog logs using a query and a time range of up to 15 days, with optional index, limit, and pagination cursor; times are Unix timestamps in milliseconds. Returned log fields are flattened, nextLogId can be used to request another page, and total counts the current page.

Input Parameters

string
Index name to search in Use DATADOG_LIST_LOG_INDEXES to discover available indexes; an incorrect or omitted index can silently exclude valid logs.
integer
Maximum number of logs to return (max 1000, default 50)
string
required
Log search query string
integer
required
End time as UNIX timestamp (in milliseconds). Note: Time range cannot exceed 15 days.
string
Pagination cursor for next page (use ‘nextLogId’ from previous response). IMPORTANT: Cursors expire quickly and can only be used with the exact same query and time parameters they were generated from. If you receive an ‘Invalid startAt’ error, omit this parameter and start a fresh search. More results are available when nextLogId is present in the response; omitting pagination silently drops those results.
integer
required
Start time as UNIX timestamp (in milliseconds). Note: Time range cannot exceed 15 days.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_LOGS_V2Search logs (POST). Uses POST /api/v2/logs/events/search. Supply the documented payload in body. Datadog permission(s): logs_read_data.

Input Parameters

object
The request for a logs list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_METRICSSearch metric names reported to Datadog in the last 24 hours. Datadog has deprecated this substring-search endpoint. Use it only when a name query is needed; use DATADOG_LIST_METRICS for timestamp-based discovery.

Input Parameters

string
required
Metric-name search text; may include the metrics: prefix.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_MONITOR_GROUPSSearches triggered Datadog monitor groups using monitor-group query grammar.

Input Parameters

integer
Zero-based page to return.
string
Sort field and direction separated by a comma. Supported fields are name, status, and tags; directions are asc and desc.
string
Monitor-group query using Datadog’s triggered-monitor search grammar, such as ‘type:metric group_status:alert’.
integer
Number of monitor groups to return per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_MONITORSSearch monitor configurations using Datadog’s monitor query grammar.

Input Parameters

integer
Zero-based page to return.
string
Sort field and direction separated by a comma. Supported fields are name, status, and tags; directions are asc and desc.
string
Monitor query using Datadog’s manage-monitor search grammar, such as ‘type:metric status:alert’.
integer
Number of monitors to return per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_SLOSearch for SLOs. Uses GET /api/v1/slo/search. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): slos_read.

Input Parameters

string
The query string to filter results based on SLO names. Some examples of queries include service:<service-name> and <slo-name>.
integer
The number of files to return in the response [default=10].
integer
The identifier of the first page to return. This parameter is used for the pagination feature [default=0].
boolean
Whether or not to return facet information in the response [default=false].

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_SPANS_ANALYTICSSearch and analyze Datadog trace span data using filters, grouping, and aggregations. Use it to investigate latency patterns, errors, and performance bottlenecks.

Input Parameters

object
required
Filter criteria for span search
array
Aggregations to compute
object
Additional search options
array
Group by configuration for aggregations

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_SUITESSearch test suites. Uses GET /api/v2/synthetics/suites/search. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): synthetics_read.

Input Parameters

string
The sort order for the results (e.g., name,asc or name,desc).
integer
The maximum number of results to return.
string
The search query.
integer
The offset from which to start returning results.
boolean
If true, return only facets instead of full test details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_TESTSSearch Synthetic tests. Uses GET /api/v1/synthetics/tests/search. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): synthetics_read.

Input Parameters

string
The sort order for the results (e.g., name,asc or name,desc).
string
The search query.
integer
The maximum number of results to return.
integer
The offset from which to start returning results.
boolean
If true, return only facets instead of full test details.
boolean
If true, include the full configuration for each test in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEARCH_TRACESSearch Datadog APM span events across services using a query and time window, for investigating request flows and performance issues. Supports sorting and cursor pagination; pagination metadata and links may be returned.

Input Parameters

object
Pagination options Check ‘meta.page.after’ or ‘links.next’ in the response to detect additional pages; pass the cursor value into ‘page.cursor’ to retrieve subsequent pages.
object
Sort configuration for trace search.
object
required
Filter criteria for trace search Custom span attributes must be prefixed with ’@’ (e.g., ‘@workflow_id’); omitting the prefix silently returns zero results. Use bounded UTC timestamp ranges — wide windows (e.g., 30 days) slow queries and may trigger rate-limit errors. Include ‘env’ and ‘service’ fields to avoid broad, noisy result sets.
object
Additional search options

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SEND_PUBLIC_DASHBOARD_INVITATIONSend shared dashboard invitation email. Uses POST /api/v1/dashboard/public/{token}/invitation. Supply the documented payload in body. Datadog permission(s): dashboards_invite_share.

Input Parameters

object
required
Shared Dashboard Invitation request body.
string
required
The token of the shared dashboard.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SET_ON_DEMAND_CONCURRENCY_CAPSave new value for on-demand concurrency cap. Uses POST /api/v2/synthetics/settings/on_demand_concurrency_cap. Supply the documented payload in body. Datadog permission(s): billing_edit.

Input Parameters

object
required
.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SET_TEAM_ROUTING_RULESReplaces (sets) the On-Call routing rules for a Datadog team.

Input Parameters

object
required
The team routing rules to set (JSON:API data object).
string
required
Unique identifier of the Datadog On-Call team whose routing rules should be replaced.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SUBMIT_DISTRIBUTION_POINTSSubmit distribution points. Uses POST /api/v1/distribution_points. Supply the documented payload in body.

Input Parameters

object
required
The documented request body.
string
HTTP header used to compress the media-type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SUBMIT_LOGSend logs. Uses POST /api/v2/logs. Supply the documented payload in body. Uses the documented regional intake endpoint.

Input Parameters

array
required
Log to send (JSON format).
string
Log tags can be passed as query parameters with text/plain content type.
string ("identity" | "gzip" | "deflate")
HTTP header used to compress the media-type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SUBMIT_METRICSSubmits custom metrics to Datadog. Useful for sending application-specific metrics, business KPIs, or custom performance indicators.

Input Parameters

array
required
List of metric series to submit

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SUBMIT_METRICS_V2Submit metrics. Uses POST /api/v2/series. Supply the documented payload in body.

Input Parameters

object
required
The documented request body.
string ("deflate" | "zstd1" | "gzip")
HTTP header used to compress the media-type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_SUBMIT_SERVICE_CHECKSubmit one or more service checks using POST /api/v1/check_run. Supply the service checks in the body.

Input Parameters

array
required
Service Check request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_TRIGGER_CI_TESTSTrigger tests from CI/CD pipelines. Uses POST /api/v1/synthetics/tests/trigger/ci. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
Details of the test to trigger.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_TRIGGER_TESTSTrigger Synthetic tests. Uses POST /api/v1/synthetics/tests/trigger. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
The identifiers of the tests to trigger.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UNMUTE_MONITORUnmute a monitor in Datadog. Re-enables alerts from a previously muted monitor, returning it to normal monitoring and alerting behavior. Alerting resumes immediately upon call, so ensure maintenance or issue resolution is fully complete before unmuting to avoid alert storms. Use this after maintenance windows or issue resolution to resume monitoring.

Input Parameters

boolean
Whether to unmute the monitor for all scopes (default: false)
integer
required
The ID of the monitor to unmute

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_API_TESTEdit an API test. Uses PUT /api/v1/synthetics/tests/api/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
New test details to be saved.
string
required
The public ID of the test to get details from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_BROWSER_TESTEdit a browser test. Uses PUT /api/v1/synthetics/tests/browser/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
New test details to be saved.
string
required
The public ID of the test to edit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_DASHBOARDUpdate a dashboard in Datadog. Updates an existing dashboard with new configuration, widgets, or layout while preserving its identity and creation metadata.

Input Parameters

array
Tags to associate with the dashboard
string
Dashboard title
array
List of widgets to include in the dashboard
string
Dashboard description
string
Dashboard layout type (‘ordered’ or ‘free’)
array
List of users to notify of dashboard changes
string
Reflow type for ordered layout dashboards (‘auto’ or ‘fixed’). Forwarded to Datadog only when set so existing values aren’t clobbered.
string
required
Dashboard ID to update
boolean
Whether the dashboard is read-only
boolean
Whether automatic refresh is paused for this dashboard. Forwarded to Datadog only when set so existing values aren’t clobbered.
array
Template variables for dynamic dashboards

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_DASHBOARD_LISTUpdate a dashboard list. Uses PUT /api/v1/dashboard/lists/manual/{list_id}. Supply the documented payload in body. Datadog permission(s): dashboards_write.

Input Parameters

object
required
Update a dashboard list request body.
integer
required
ID of the dashboard list to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_DASHBOARD_LIST_ITEMSReplace the dashboards in a manual dashboard list with the supplied list using PUT /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards.

Input Parameters

object
required
New dashboards of the dashboard list.
integer
required
ID of the dashboard list to update items from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_DERIVED_METRICUpdate a derived metric. Uses PUT /api/v2/metrics/derived-metrics/{metric_name}. Supply the documented payload in body; body.data.id must match metric_name. Datadog permission(s): metric_tags_write.

Input Parameters

object
required
The documented request body.
string
required
The name of the metric.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_DOWNTIMEUpdate a downtime. Uses PATCH /api/v2/downtime/{downtime_id}. Supply the documented payload in body. Datadog permission(s): monitors_downtime.

Input Parameters

object
required
Update a downtime request body.
string
required
ID of the downtime to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_ESCALATION_POLICYUpdates a Datadog On-Call escalation policy by ID.

Input Parameters

object
required
The Datadog On-Call escalation policy update (JSON:API data object).
string
required
Unique identifier of the On-Call escalation policy to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_HOST_TAGSUpdates tags for a specific host in Datadog. This replaces all existing tags from the specified source with the new tags provided.

Input Parameters

array
required
List of tags to assign to the host (replaces existing tags)
string
Source of the tags (e.g., ‘users’, ‘chef’, ‘puppet’). Defaults to ‘users’
string
required
Name of the host to update tags for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_METRIC_METADATAEdit metric metadata. Uses PUT /api/v1/metrics/{metric_name}. Supply the documented payload in body. Datadog permission(s): metrics_metadata_write.

Input Parameters

object
required
New metadata.
string
required
Name of the metric for which to edit metadata.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_MOBILE_TESTEdit a mobile test. Uses PUT /api/v1/synthetics/tests/mobile/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
New test details to be saved.
string
required
The public ID of the test to get details from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_MONITORUpdates an existing Datadog monitor with new configuration, thresholds, or notification settings. Only specified fields will be updated.

Input Parameters

string
Name of the monitor
array
List of tags to assign to the monitor
string ("metric alert" | "service check" | "event alert" | "query alert" | "composite" | "log alert")
Type of monitor.
string
Query that defines what the monitor tracks
string
Message to include in notifications (supports @mentions and markdown)
object
Monitor update configuration options.
integer
Priority level (1-5, where 1 is highest)
integer
required
The ID of the monitor to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_MONITOR_CONFIG_POLICYEdit a monitor configuration policy. Uses PATCH /api/v2/monitor/policy/{policy_id}. Supply the documented payload in body. Datadog permission(s): monitor_config_policy_write.

Input Parameters

object
required
Description of the update.
string
required
ID of the monitor configuration policy.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_MONITOR_NOTIFICATION_RULEUpdate a monitor notification rule. Uses PATCH /api/v2/monitor/notification_rule/{rule_id}. Supply the documented payload in body. Datadog permission(s): monitor_config_policy_write.

Input Parameters

object
required
Request body to update the monitor notification rule.
string
required
ID of the monitor notification rule to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_NOTEBOOKUpdate a notebook using PUT /api/v1/notebooks/{notebook_id}, supplying the notebook payload in body. Existing cells omitted from the supplied cell list are deleted; Datadog permission: notebooks_write.

Input Parameters

object
required
Update notebook request body.
integer
required
Unique ID, assigned when you create the notebook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_NOTIFICATION_RULEUpdates an On-Call notification rule for a user by ID.

Input Parameters

object
required
The On-Call notification rule update (JSON:API data object).
string
required
Unique identifier of the On-Call notification rule to update.
string
required
Unique identifier of the user whose On-Call notification rule you want to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_PRIVATE_LOCATIONEdit a private location. Uses PUT /api/v1/synthetics/private-locations/{location_id}. Supply the documented payload in body. Datadog permission(s): synthetics_private_location_write.

Input Parameters

object
required
Details of the private location to be updated.
string
required
The ID of the private location.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_PUBLIC_DASHBOARDUpdate a shared dashboard. Uses PUT /api/v1/dashboard/public/{token}. Supply the documented payload in body. Datadog permission(s): dashboards_public_share, dashboards_embed_share, dashboards_invite_share.

Input Parameters

object
required
Update Dashboard request body.
string
required
The token of the shared dashboard.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_SCHEDULEUpdates a Datadog On-Call schedule by ID.

Input Parameters

object
required
The Datadog On-Call schedule update (JSON:API data object).
string
required
Unique identifier of the Datadog On-Call schedule to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_SLOUpdate an SLO. Uses PUT /api/v1/slo/{slo_id}. Supply the documented payload in body. Datadog permission(s): slos_write.

Input Parameters

object
required
The edited service level objective request object.
string
required
The ID of the service level objective object.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_SYNTHETICS_DOWNTIMEUpdate a Synthetics downtime. Uses PUT /api/v2/synthetics/downtimes/{downtime_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write, synthetics_default_settings_write.

Input Parameters

object
required
The documented request body.
string
required
The ID of the downtime to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_SYNTHETICS_NETWORK_TESTEdit a Network Path test. Uses PUT /api/v2/synthetics/tests/network/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write, synthetics_create_edit_trigger.

Input Parameters

object
required
New Network Path test details to be saved.
string
required
The public ID of the Network Path test to edit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_TAG_CONFIGURATIONUpdate a tag configuration. Uses PATCH /api/v2/metrics/{metric_name}/tags. Supply the documented payload in body. Datadog permission(s): metric_tags_write.

Input Parameters

object
required
The documented request body.
string
required
The name of the metric.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPDATE_TEST_PAUSE_STATUSPause or start a test. Uses PUT /api/v1/synthetics/tests/{public_id}/status. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Input Parameters

object
required
Status to set the given Synthetic test to.
string
required
The public ID of the Synthetic test to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPSERT_CATALOG_ENTITYCreate or update entities. Uses POST /api/v2/catalog/entity. Supply the documented payload in body.

Input Parameters

string
required
Entity YAML or JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_UPSERT_CATALOG_KINDCreate or update kinds. Uses POST /api/v2/catalog/kind. Supply the documented payload in body.

Input Parameters

string
required
Kind YAML or JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_VALIDATE_API_KEYCheck that the API and application keys are both valid. Uses GET /api/v2/validate_keys. Returns {“status”: “ok”} on success; invalid credentials produce HTTP 401 or 403. No additional permissions required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_VALIDATE_MONITORValidate a Datadog monitor definition without creating or updating it.

Input Parameters

string
Monitor name.
array
Tags assigned to the monitor.
string ("composite" | "event alert" | "log alert" | "metric alert" | "process alert" | "query alert" | "rum alert" | "service check" | "synthetics alert" | "trace-analytics alert" | "slo alert" | "event-v2 alert" | "audit alert" | "ci-pipelines alert" | "ci-tests alert" | "error-tracking alert" | "database-monitoring alert" | "network-performance alert" | "cost alert" | "data-quality alert" | "network-path alert" | "data-jobs alert" | "llm-observability alert")
required
Type of monitor to validate.
string
required
Datadog query whose syntax must match the monitor type.
array
Links that help users act on monitor alerts.
string
Notification message, including any mentions or Markdown.
object
Common options accepted by Datadog monitor creation and validation.
integer
Alert priority from 1 (highest) to 5 (lowest).
string ("draft" | "published")
Whether the monitor is a non-notifying draft or is published.
array
Role UUIDs permitted to edit the monitor.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATADOG_VALIDATE_MONITOR_UPDATEValidate a proposed configuration for an existing monitor without applying it.

Input Parameters

string
Proposed monitor name to validate.
array
Proposed monitor tags to validate.
string ("composite" | "event alert" | "log alert" | "metric alert" | "process alert" | "query alert" | "rum alert" | "service check" | "synthetics alert" | "trace-analytics alert" | "slo alert" | "event-v2 alert" | "audit alert" | "ci-pipelines alert" | "ci-tests alert" | "error-tracking alert" | "database-monitoring alert" | "network-performance alert" | "cost alert" | "data-quality alert" | "network-path alert" | "data-jobs alert" | "llm-observability alert")
required
Datadog monitor type for the proposed configuration.
string
required
Monitor query to validate. Its syntax must match the monitor type.
array
Monitor assets, such as runbook links, to validate.
string
Proposed monitor notification message to validate.
object
Proposed monitor options and thresholds to validate.
integer
Proposed monitor priority, or null to clear it.
integer
required
ID of the existing monitor whose proposed configuration is validated.
string ("draft" | "published")
Proposed monitor state: draft or published.
array
Role IDs allowed to edit the monitor, or null to remove restrictions.
array
Active v1 downtimes associated with the monitor.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not