> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Datadog

> Datadog offers monitoring, observability, and security for cloud-scale applications, unifying metrics, logs, and traces to help teams detect issues and optimize performance

![Datadog logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/datadog.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=221682560fefacf5f270273223913d4e)

* **Category:** server monitoring
* **Auth:** OAUTH2, API\_KEY, BEARER\_TOKEN
* **Composio-managed OAuth available?** No
* **Tools:** 249
* **Triggers:** 0
* **Slug:** `DATADOG`
* **Version:** 20261101\_00

## Tools

> [accordion] Abort a multipart upload of a test file
>
> **Slug:** `DATADOG_ABORT_TEST_FILE_MULTIPART_UPLOAD`
>
> Abort 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
>
> **body** `object` *required*
>
> The documented request body.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Acknowledge On-Call Page
>
> **Slug:** `DATADOG_ACKNOWLEDGE_ON_CALL_PAGE`
>
> Acknowledge 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
>
> **page\_id** `string` *required*
>
> The page ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a test to a Synthetics downtime
>
> **Slug:** `DATADOG_ADD_TEST_TO_SYNTHETICS_DOWNTIME`
>
> Add a test to a Synthetics downtime. Uses PUT /api/v2/synthetics/downtimes/\{downtime\_id}/tests/\{test\_id}. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **test\_id** `string` *required*
>
> The public ID of the Synthetics test to associate with the downtime.
>
> **downtime\_id** `string` *required*
>
> The ID of the downtime.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Aggregate logs
>
> **Slug:** `DATADOG_AGGREGATE_LOGS`
>
> Aggregate 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
>
> **page** `object`
>
> Continues an alphabetically sorted aggregate query.
>
> **filter** `object`
>
> Log query, time range, indexes, and storage tier to analyze.
>
> **compute** `array`
>
> Calculations to perform; defaults to total log count.
>
> **group\_by** `array`
>
> Facets used to divide results into buckets.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Cancel a downtime
>
> **Slug:** `DATADOG_CANCEL_DOWNTIME`
>
> Cancel a downtime. Uses DELETE /api/v2/downtime/\{downtime\_id}. Datadog permission(s): monitors\_downtime.
>
> #### Input Parameters
>
> **downtime\_id** `string` *required*
>
> ID of the downtime to cancel.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check if a monitor can be deleted
>
> **Slug:** `DATADOG_CHECK_CAN_DELETE_MONITOR`
>
> Check if the given monitors can be deleted. Uses GET /api/v1/monitor/can\_delete. Datadog permission(s): monitors\_read.
>
> #### Input Parameters
>
> **monitor\_ids** `array` *required*
>
> The IDs of the monitor to check.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check if SLOs can be safely deleted
>
> **Slug:** `DATADOG_CHECK_CAN_DELETE_SLO`
>
> Check 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
>
> **ids** `string` *required*
>
> A comma separated list of the IDs of the service level objectives objects.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Complete a multipart upload of a test file
>
> **Slug:** `DATADOG_COMPLETE_TEST_FILE_MULTIPART_UPLOAD`
>
> Complete 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
>
> **body** `object` *required*
>
> The documented request body.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create an API test
>
> **Slug:** `DATADOG_CREATE_API_TEST`
>
> Create an API test. Uses POST /api/v1/synthetics/tests/api. Supply the documented payload in body. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Details of the test to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Dashboard
>
> **Slug:** `DATADOG_CREATE_DASHBOARD`
>
> Create a dashboard in Datadog. Dashboards provide customizable visualizations for monitoring your infrastructure, applications, and business metrics in a unified view.
>
> #### Input Parameters
>
> **tags** `array`
>
> Tags to associate with the dashboard
>
> **title** `string` *required*
>
> Dashboard title
>
> **widgets** `array` *required*
>
> List of widgets to include in the dashboard
>
> **description** `string`
>
> Dashboard description
>
> **layout\_type** `string ("ordered" | "free")`
>
> Dashboard layout type.
>
> **notify\_list** `array`
>
> List of users to notify of dashboard changes
>
> **template\_variables** `array`
>
> Template variables for dynamic dashboards
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a dashboard list
>
> **Slug:** `DATADOG_CREATE_DASHBOARD_LIST`
>
> Create a dashboard list. Uses POST /api/v1/dashboard/lists/manual. Supply the documented payload in body. Datadog permission(s): dashboards\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Create a dashboard list request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Items to a Dashboard List
>
> **Slug:** `DATADOG_CREATE_DASHBOARD_LIST_ITEMS`
>
> Add Items to a Dashboard List. Uses POST /api/v2/dashboard/lists/manual/\{dashboard\_list\_id}/dashboards. Supply the documented payload in body.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Dashboards to add to the dashboard list.
>
> **dashboard\_list\_id** `integer` *required*
>
> ID of the dashboard list to add items to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a derived metric
>
> **Slug:** `DATADOG_CREATE_DERIVED_METRIC`
>
> Create a derived metric. Uses POST /api/v2/metrics/derived-metrics. Supply the documented payload in body. Datadog permission(s): metric\_tags\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> The documented request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create downtime
>
> **Slug:** `DATADOG_CREATE_DOWNTIME`
>
> Creates 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
>
> **end** `integer`
>
> UNIX timestamp when downtime should end
>
> **scope** `array` *required*
>
> Scope to apply downtime to (host, service, or monitor tags)
>
> **start** `integer`
>
> UNIX timestamp when downtime should start. If not provided, starts immediately
>
> **message** `string`
>
> Message to include with the downtime
>
> **timezone** `string`
>
> Timezone for the downtime (e.g., 'UTC', 'America/New\_York')
>
> **monitor\_id** `integer`
>
> Monitor ID to schedule downtime for (optional, can use scope instead)
>
> **recurrence** `object`
>
> Downtime recurrence configuration.
>
> **monitor\_tags** `array`
>
> Monitor tags to match for downtime
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create On-Call escalation policy
>
> **Slug:** `DATADOG_CREATE_ESCALATION_POLICY`
>
> Creates a Datadog On-Call escalation policy.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The Datadog On-Call escalation policy to create (JSON:API `data` object).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create event
>
> **Slug:** `DATADOG_CREATE_EVENT`
>
> Creates a new event in Datadog. Events are useful for tracking deployments, outages, configuration changes, and other important occurrences.
>
> #### Input Parameters
>
> **host** `string`
>
> Host name associated with the event
>
> **tags** `array`
>
> List of tags to associate with the event
>
> **text** `string` *required*
>
> Event text/description (supports Markdown)
>
> **title** `string` *required*
>
> Event title (limited to 100 characters)
>
> **priority** `string ("normal" | "low")`
>
> Event priority.
>
> **alert\_type** `string ("error" | "warning" | "info" | "success")`
>
> Alert type.
>
> **device\_name** `string`
>
> Device name associated with the event
>
> **date\_happened** `integer`
>
> UNIX timestamp when the event occurred. If not provided, current time is used
>
> **aggregation\_key** `string`
>
> Key for aggregating events together
>
> **source\_type\_name** `string`
>
> Source type name (e.g., 'jenkins', 'docker', 'ansible')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Post an event
>
> **Slug:** `DATADOG_CREATE_EVENT_V2`
>
> Post an event. Uses POST /api/v2/events. Supply the documented payload in body. Uses the documented regional intake endpoint.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Event creation request payload.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a global variable
>
> **Slug:** `DATADOG_CREATE_GLOBAL_VARIABLE`
>
> Create a global variable. Uses POST /api/v1/synthetics/variables. Supply the documented payload in body. Datadog permission(s): synthetics\_global\_variable\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Details of the global variable to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create graph snapshot
>
> **Slug:** `DATADOG_CREATE_GRAPH_SNAPSHOT`
>
> Create a hosted PNG snapshot from a metric query or graph definition. The returned snapshot URL may take time to become available.
>
> #### Input Parameters
>
> **end** `integer` *required*
>
> POSIX timestamp in seconds for the end of the graph's time range.
>
> **start** `integer` *required*
>
> POSIX timestamp in seconds for the start of the graph's time range.
>
> **title** `string`
>
> Title displayed on the graph. Omit it to create a graph without a title.
>
> **width** `integer`
>
> Graph width in pixels. Omit it to use the graph's original width.
>
> **height** `integer`
>
> Graph height in pixels. Omit it to use the graph's original height.
>
> **graph\_def** `string`
>
> Single-line JSON graph definition to render. Provide exactly one of graph\_def or metric\_query.
>
> **event\_query** `string`
>
> Query that adds event bands to the graph.
>
> **metric\_query** `string`
>
> Datadog metric query to render. Provide exactly one of metric\_query or graph\_def.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create an incident impact
>
> **Slug:** `DATADOG_CREATE_INCIDENT_IMPACT`
>
> Create an incident impact. Uses POST /api/v2/incidents/\{incident\_id}/impacts. Supply the documented payload in body. Datadog permission(s): incident\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Incident impact payload.
>
> **include** `array`
>
> Specifies which related resources should be included in the response.
>
> **incident\_id** `string` *required*
>
> The UUID of the incident.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create monitor
>
> **Slug:** `DATADOG_CREATE_MONITOR`
>
> Creates a new Datadog monitor to track metrics, logs, or other data sources with configurable alerting thresholds and notifications.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the monitor
>
> **tags** `array`
>
> List of tags to assign to the monitor
>
> **type** `string ("metric alert" | "service check" | "event alert" | "query alert" | "composite" | "log alert")` *required*
>
> Type of monitor.
>
> **query** `string` *required*
>
> Query that defines what the monitor tracks Query syntax must match the monitor `type` exactly — a mismatch will cause creation to fail.
>
> **message** `string`
>
> Message to include in notifications (supports @mentions and markdown)
>
> **options** `object`
>
> Monitor configuration options.
>
> **priority** `integer`
>
> Priority level (1-5, where 1 is highest)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a monitor configuration policy
>
> **Slug:** `DATADOG_CREATE_MONITOR_CONFIG_POLICY`
>
> Create 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
>
> **body** `object` *required*
>
> Create a monitor configuration policy request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a monitor notification rule
>
> **Slug:** `DATADOG_CREATE_MONITOR_NOTIFICATION_RULE`
>
> Create 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
>
> **body** `object` *required*
>
> Request body to create a monitor notification rule.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a notebook
>
> **Slug:** `DATADOG_CREATE_NOTEBOOK`
>
> Create a notebook. Uses POST /api/v1/notebooks. Supply the documented payload in body. Datadog permission(s): notebooks\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> The JSON description of the notebook you want to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create On-Call notification channel
>
> **Slug:** `DATADOG_CREATE_NOTIFICATION_CHANNEL`
>
> Creates an On-Call notification channel for a Datadog user.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The On-Call notification channel to create (JSON:API `data` object).
>
> **user\_id** `string` *required*
>
> Unique identifier of the Datadog user who will own the On-Call notification channel.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create On-Call notification rule
>
> **Slug:** `DATADOG_CREATE_NOTIFICATION_RULE`
>
> Creates an On-Call notification rule for a Datadog user.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The On-Call notification rule to create (JSON:API `data` object).
>
> **user\_id** `string` *required*
>
> Unique identifier of the Datadog user whose On-Call notification rule will be created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create On-Call Page
>
> **Slug:** `DATADOG_CREATE_ON_CALL_PAGE`
>
> Create 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
>
> **body** `object` *required*
>
> The documented request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create or update service definition
>
> **Slug:** `DATADOG_CREATE_OR_UPDATE_SERVICE_DEFINITIONS`
>
> Create 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
>
> **body** `string` *required*
>
> Service Definition YAML/JSON.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a shared dashboard
>
> **Slug:** `DATADOG_CREATE_PUBLIC_DASHBOARD`
>
> Create 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
>
> **body** `object` *required*
>
> Create a shared dashboard request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create On-Call schedule
>
> **Slug:** `DATADOG_CREATE_SCHEDULE`
>
> Creates a Datadog On-Call schedule.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The Datadog On-Call schedule to create (JSON:API `data` object).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create On-Call schedule overrides
>
> **Slug:** `DATADOG_CREATE_SCHEDULE_OVERRIDES`
>
> Create 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
>
> **body** `object` *required*
>
> The documented request body.
>
> **include** `string`
>
> Comma-separated list of included relationships to be returned. Allowed values: `user`, `overridden_user`, `user.color`.
>
> **schedule\_id** `string` *required*
>
> The ID of the schedule.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create SLO
>
> **Slug:** `DATADOG_CREATE_SLO`
>
> Create a metric-based or monitor-based Service Level Objective (SLO) in Datadog to track service reliability targets.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> SLO display name
>
> **tags** `array`
>
> Tags to associate with the SLO (format: 'key:value')
>
> **type** `string ("metric" | "monitor")` *required*
>
> SLO type.
>
> **query** `object`
>
> Query specification for metric-based SLOs.
>
> **groups** `array`
>
> List of groups for the SLO scope
>
> **thresholds** `array` *required*
>
> List of SLO target thresholds
>
> **description** `string`
>
> Optional description of the SLO
>
> **monitor\_ids** `array`
>
> Monitor IDs for monitor-based SLOs
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Synthetic API Test
>
> **Slug:** `DATADOG_CREATE_SYNTHETIC_API_TEST`
>
> Create 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
>
> **name** `string` *required*
>
> Name of the synthetic test
>
> **tags** `array`
>
> Tags to associate with the test
>
> **type** `string`
>
> Type of synthetic test (always 'api' for API tests)
>
> **config** `object` *required*
>
> Test configuration including request and assertions
>
> **status** `string ("live" | "paused")`
>
> Test status.
>
> **message** `string`
>
> Message to include in notifications
>
> **options** `object` *required*
>
> Test execution options
>
> **subtype** `string ("http" | "ssl" | "tcp" | "dns" | "icmp")`
>
> Subtype of test.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a browser test
>
> **Slug:** `DATADOG_CREATE_SYNTHETICS_BROWSER_TEST`
>
> Create a browser test. Uses POST /api/v1/synthetics/tests/browser. Supply the documented payload in body. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Details of the test to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a Synthetics downtime
>
> **Slug:** `DATADOG_CREATE_SYNTHETICS_DOWNTIME`
>
> Create 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
>
> **body** `object` *required*
>
> The documented request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a mobile test
>
> **Slug:** `DATADOG_CREATE_SYNTHETICS_MOBILE_TEST`
>
> Create a mobile test. Uses POST /api/v1/synthetics/tests/mobile. Supply the documented payload in body. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Details of the test to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a Network Path test
>
> **Slug:** `DATADOG_CREATE_SYNTHETICS_NETWORK_TEST`
>
> Create 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
>
> **body** `object` *required*
>
> The documented request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a test suite
>
> **Slug:** `DATADOG_CREATE_SYNTHETICS_SUITE`
>
> Create 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
>
> **body** `object` *required*
>
> The documented request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a tag configuration
>
> **Slug:** `DATADOG_CREATE_TAG_CONFIGURATION`
>
> Create 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
>
> **body** `object` *required*
>
> The documented request body.
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Webhook
>
> **Slug:** `DATADOG_CREATE_WEBHOOK`
>
> Create 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
>
> **url** `string` *required*
>
> URL endpoint for the webhook Must be a reachable HTTPS endpoint.
>
> **name** `string` *required*
>
> Name of the webhook
>
> **payload** `string`
>
> Custom payload template (optional)
>
> **encode\_as** `string`
>
> Encoding type: 'json' or 'form'
>
> **custom\_headers** `string`
>
> Custom headers in JSON format (optional)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a single entity
>
> **Slug:** `DATADOG_DELETE_CATALOG_ENTITY`
>
> Delete a single entity. Uses DELETE /api/v2/catalog/entity/\{entity\_id}.
>
> #### Input Parameters
>
> **entity\_id** `string` *required*
>
> UUID or Entity Ref.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a single kind
>
> **Slug:** `DATADOG_DELETE_CATALOG_KIND`
>
> Delete a single kind. Uses DELETE /api/v2/catalog/kind/\{kind\_id}.
>
> #### Input Parameters
>
> **kind\_id** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Dashboard
>
> **Slug:** `DATADOG_DELETE_DASHBOARD`
>
> Delete a dashboard in Datadog. Permanently removes a dashboard from your organization. This action cannot be undone. Use with caution.
>
> #### Input Parameters
>
> **dashboard\_id** `string` *required*
>
> Dashboard ID to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a dashboard list
>
> **Slug:** `DATADOG_DELETE_DASHBOARD_LIST`
>
> Delete a dashboard list. Uses DELETE /api/v1/dashboard/lists/manual/\{list\_id}. Datadog permission(s): dashboards\_write.
>
> #### Input Parameters
>
> **list\_id** `integer` *required*
>
> ID of the dashboard list to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete items from a dashboard list
>
> **Slug:** `DATADOG_DELETE_DASHBOARD_LIST_ITEMS`
>
> Delete items from a dashboard list. Uses DELETE /api/v2/dashboard/lists/manual/\{dashboard\_list\_id}/dashboards. Supply the documented payload in body.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Dashboards to delete from the dashboard list.
>
> **dashboard\_list\_id** `integer` *required*
>
> ID of the dashboard list to delete items from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete dashboards
>
> **Slug:** `DATADOG_DELETE_DASHBOARDS`
>
> Delete 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
>
> **body** `object` *required*
>
> Delete dashboards request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a derived metric
>
> **Slug:** `DATADOG_DELETE_DERIVED_METRIC`
>
> Delete a derived metric. Uses DELETE /api/v2/metrics/derived-metrics/\{metric\_name}. Datadog permission(s): metric\_tags\_write.
>
> #### Input Parameters
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete On-Call escalation policy
>
> **Slug:** `DATADOG_DELETE_ESCALATION_POLICY`
>
> Deletes a Datadog On-Call escalation policy by ID. This action cannot be undone.
>
> #### Input Parameters
>
> **policy\_id** `string` *required*
>
> Unique identifier of the Datadog On-Call escalation policy to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a global variable
>
> **Slug:** `DATADOG_DELETE_GLOBAL_VARIABLE`
>
> Delete a global variable. Uses DELETE /api/v1/synthetics/variables/\{variable\_id}. Datadog permission(s): synthetics\_global\_variable\_write.
>
> #### Input Parameters
>
> **variable\_id** `string` *required*
>
> The ID of the global variable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an incident impact
>
> **Slug:** `DATADOG_DELETE_INCIDENT_IMPACT`
>
> Delete an incident impact. Uses DELETE /api/v2/incidents/\{incident\_id}/impacts/\{impact\_id}. Datadog permission(s): incident\_write.
>
> #### Input Parameters
>
> **impact\_id** `string` *required*
>
> The UUID of the incident impact.
>
> **incident\_id** `string` *required*
>
> The UUID of the incident.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete monitor
>
> **Slug:** `DATADOG_DELETE_MONITOR`
>
> Deletes a Datadog monitor permanently. Use with caution as this action cannot be undone.
>
> #### Input Parameters
>
> **force** `boolean`
>
> Force delete the monitor (skip confirmation)
>
> **monitor\_id** `integer` *required*
>
> The ID of the monitor to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a monitor configuration policy
>
> **Slug:** `DATADOG_DELETE_MONITOR_CONFIG_POLICY`
>
> Delete a monitor configuration policy. Uses DELETE /api/v2/monitor/policy/\{policy\_id}. Datadog permission(s): monitor\_config\_policy\_write.
>
> #### Input Parameters
>
> **policy\_id** `string` *required*
>
> ID of the monitor configuration policy.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a monitor notification rule
>
> **Slug:** `DATADOG_DELETE_MONITOR_NOTIFICATION_RULE`
>
> Delete a monitor notification rule. Uses DELETE /api/v2/monitor/notification\_rule/\{rule\_id}. Datadog permission(s): monitor\_config\_policy\_write.
>
> #### Input Parameters
>
> **rule\_id** `string` *required*
>
> ID of the monitor notification rule to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a notebook
>
> **Slug:** `DATADOG_DELETE_NOTEBOOK`
>
> Delete a notebook. Uses DELETE /api/v1/notebooks/\{notebook\_id}. Datadog permission(s): notebooks\_write.
>
> #### Input Parameters
>
> **notebook\_id** `integer` *required*
>
> Unique ID, assigned when you create the notebook.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete On-Call notification channel
>
> **Slug:** `DATADOG_DELETE_NOTIFICATION_CHANNEL`
>
> Deletes an On-Call notification channel for a Datadog user. This action cannot be undone.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> Unique identifier of the user who owns the On-Call notification channel to delete.
>
> **channel\_id** `string` *required*
>
> Unique identifier of the On-Call notification channel to delete for the user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete On-Call notification rule
>
> **Slug:** `DATADOG_DELETE_NOTIFICATION_RULE`
>
> Deletes an On-Call notification rule for a Datadog user. This action cannot be undone.
>
> #### Input Parameters
>
> **rule\_id** `string` *required*
>
> Unique identifier of the On-Call notification rule to permanently delete.
>
> **user\_id** `string` *required*
>
> Unique identifier of the user who owns the On-Call notification rule to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a private location
>
> **Slug:** `DATADOG_DELETE_PRIVATE_LOCATION`
>
> Delete a private location. Uses DELETE /api/v1/synthetics/private-locations/\{location\_id}. Datadog permission(s): synthetics\_private\_location\_write.
>
> #### Input Parameters
>
> **location\_id** `string` *required*
>
> The ID of the private location.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Revoke a shared dashboard URL
>
> **Slug:** `DATADOG_DELETE_PUBLIC_DASHBOARD`
>
> Revoke 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
>
> **token** `string` *required*
>
> The token of the shared dashboard.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Revoke shared dashboard invitations
>
> **Slug:** `DATADOG_DELETE_PUBLIC_DASHBOARD_INVITATION`
>
> Revoke 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
>
> **body** `object` *required*
>
> Shared Dashboard Invitation deletion request body.
>
> **token** `string` *required*
>
> The token of the shared dashboard.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete On-Call schedule
>
> **Slug:** `DATADOG_DELETE_SCHEDULE`
>
> Deletes a Datadog On-Call schedule by ID. This action cannot be undone.
>
> #### Input Parameters
>
> **schedule\_id** `string` *required*
>
> Unique identifier of the Datadog On-Call schedule to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete On-Call schedule override
>
> **Slug:** `DATADOG_DELETE_SCHEDULE_OVERRIDE`
>
> Delete 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
>
> **override\_id** `string` *required*
>
> The ID of the override.
>
> **schedule\_id** `string` *required*
>
> The ID of the schedule.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a single service definition
>
> **Slug:** `DATADOG_DELETE_SERVICE_DEFINITION`
>
> Delete a single service definition. Uses DELETE /api/v2/services/definitions/\{service\_name}. Datadog permission(s): apm\_service\_catalog\_write.
>
> #### Input Parameters
>
> **service\_name** `string` *required*
>
> The name of the service.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an SLO
>
> **Slug:** `DATADOG_DELETE_SLO`
>
> Delete an SLO. Uses DELETE /api/v1/slo/\{slo\_id}. Datadog permission(s): slos\_write.
>
> #### Input Parameters
>
> **force** `string`
>
> Delete the monitor even if it's referenced by other resources (for example SLO, composite monitor).
>
> **slo\_id** `string` *required*
>
> The ID of the service level objective.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk Delete SLO Timeframes
>
> **Slug:** `DATADOG_DELETE_SLO_TIMEFRAME_IN_BULK`
>
> Delete 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
>
> **body** `object` *required*
>
> Delete multiple service level objective objects request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a Synthetics downtime
>
> **Slug:** `DATADOG_DELETE_SYNTHETICS_DOWNTIME`
>
> Delete a Synthetics downtime. Uses DELETE /api/v2/synthetics/downtimes/\{downtime\_id}. Datadog permission(s): synthetics\_write, synthetics\_default\_settings\_write.
>
> #### Input Parameters
>
> **downtime\_id** `string` *required*
>
> The ID of the downtime to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk delete suites
>
> **Slug:** `DATADOG_DELETE_SYNTHETICS_SUITES`
>
> Bulk delete suites. Uses POST /api/v2/synthetics/suites/bulk-delete. Supply the documented payload in body. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> The documented request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk delete tests
>
> **Slug:** `DATADOG_DELETE_SYNTHETICS_TESTS`
>
> Bulk delete tests. Uses POST /api/v2/synthetics/tests/bulk-delete. Supply the documented payload in body. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> The documented request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a tag configuration
>
> **Slug:** `DATADOG_DELETE_TAG_CONFIGURATION`
>
> Delete a tag configuration. Uses DELETE /api/v2/metrics/\{metric\_name}/tags. Datadog permission(s): metric\_tags\_write.
>
> #### Input Parameters
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete tests
>
> **Slug:** `DATADOG_DELETE_TESTS`
>
> Delete tests. Uses POST /api/v1/synthetics/tests/delete. Supply the documented payload in body. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Public ID list of the Synthetic tests to be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit a global variable
>
> **Slug:** `DATADOG_EDIT_GLOBAL_VARIABLE`
>
> Edit 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
>
> **body** `object` *required*
>
> Details of the global variable to update.
>
> **variable\_id** `string` *required*
>
> The ID of the global variable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit a test suite
>
> **Slug:** `DATADOG_EDIT_SYNTHETICS_SUITE`
>
> Edit a test suite. Uses PUT /api/v2/synthetics/suites/\{public\_id}. Supply the documented payload in body. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> New suite details to be saved.
>
> **public\_id** `string` *required*
>
> The public ID of the suite to edit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Escalate On-Call Page
>
> **Slug:** `DATADOG_ESCALATE_ON_CALL_PAGE`
>
> Escalate a Datadog On-Call page identified by its page ID. The result indicates whether Datadog accepted the escalation request.
>
> #### Input Parameters
>
> **page\_id** `string` *required*
>
> The page ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Tag Configuration Cardinality Estimator
>
> **Slug:** `DATADOG_ESTIMATE_METRICS_OUTPUT_SERIES`
>
> Tag Configuration Cardinality Estimator. Uses GET /api/v2/metrics/\{metric\_name}/estimate. Datadog permission(s): .
>
> #### Input Parameters
>
> **filter\_pct** `boolean`
>
> Deprecated. This query parameter has no effect on the estimate.
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> **filter\_groups** `string`
>
> Comma-separated list of tag keys that the metric is configured to query with. For example: `filter[groups]=app,host`.
>
> **filter\_hours\_ago** `integer`
>
> The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours.
>
> **filter\_timespan\_h** `integer`
>
> A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.
>
> **filter\_num\_aggregations** `integer`
>
> Deprecated. Number of aggregations has no impact on volume.
>
> **filter\_exclude\_tags\_mode** `boolean`
>
> When `true`, `filter[groups]` is treated as an exclude list instead of an include list. Defaults to `false`.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch uptime for multiple tests
>
> **Slug:** `DATADOG_FETCH_UPTIMES`
>
> Fetch uptime for multiple tests. Uses POST /api/v1/synthetics/tests/uptimes. Supply the documented payload in body. Datadog permission(s): synthetics\_read.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Public ID list of the Synthetic tests and timeframe.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get parent tests for a subtest
>
> **Slug:** `DATADOG_GET_API_MULTISTEP_SUBTEST_PARENTS`
>
> Get 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
>
> **public\_id** `string` *required*
>
> The public ID of the subtest.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get available subtests for a multistep test
>
> **Slug:** `DATADOG_GET_API_MULTISTEP_SUBTESTS`
>
> Get 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
>
> **public\_id** `string` *required*
>
> The public ID of the API multistep test.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get an API test
>
> **Slug:** `DATADOG_GET_API_TEST`
>
> Get 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
>
> **public\_id** `string` *required*
>
> The public ID of the test to get details from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get an API test's latest results summaries
>
> **Slug:** `DATADOG_GET_API_TEST_LATEST_RESULTS`
>
> Get an API test's latest results summaries. Uses GET /api/v1/synthetics/tests/\{public\_id}/results. Datadog permission(s): synthetics\_read.
>
> #### Input Parameters
>
> **to\_ts** `integer`
>
> Timestamp in milliseconds up to which to query results.
>
> **from\_ts** `integer`
>
> Timestamp in milliseconds from which to start querying results.
>
> **probe\_dc** `array`
>
> Locations for which to query results.
>
> **public\_id** `string` *required*
>
> The public ID of the test for which to search results for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get an API test result
>
> **Slug:** `DATADOG_GET_API_TEST_RESULT`
>
> Get an API test result. Uses GET /api/v1/synthetics/tests/\{public\_id}/results/\{result\_id}. Datadog permission(s): synthetics\_read.
>
> #### Input Parameters
>
> **public\_id** `string` *required*
>
> The public ID of the API test to which the target result belongs.
>
> **result\_id** `string` *required*
>
> The ID of the result to get.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a browser test
>
> **Slug:** `DATADOG_GET_BROWSER_TEST`
>
> Get 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
>
> **public\_id** `string` *required*
>
> The public ID of the test to get details from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a browser test's latest results summaries
>
> **Slug:** `DATADOG_GET_BROWSER_TEST_LATEST_RESULTS`
>
> Get 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
>
> **to\_ts** `integer`
>
> Timestamp in milliseconds up to which to query results.
>
> **from\_ts** `integer`
>
> Timestamp in milliseconds from which to start querying results.
>
> **probe\_dc** `array`
>
> Locations for which to query results.
>
> **public\_id** `string` *required*
>
> The public ID of the browser test for which to search results for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a browser test result
>
> **Slug:** `DATADOG_GET_BROWSER_TEST_RESULT`
>
> Get 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
>
> **public\_id** `string` *required*
>
> The public ID of the browser test to which the target result belongs.
>
> **result\_id** `string` *required*
>
> The ID of the result to get.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Custom Evaluator Configuration
>
> **Slug:** `DATADOG_GET_CUSTOM_EVALUATOR_CONFIGURATION`
>
> Retrieve one custom Agent Observability evaluator configuration by name. Datadog currently exposes this read operation as a preview API.
>
> #### Input Parameters
>
> **eval\_name** `string` *required*
>
> Exact name of the custom evaluator configuration to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Dashboard
>
> **Slug:** `DATADOG_GET_DASHBOARD`
>
> Get a specific dashboard from Datadog. Retrieves detailed information about a dashboard including its widgets, layout, template variables, and metadata.
>
> #### Input Parameters
>
> **dashboard\_id** `string` *required*
>
> Dashboard ID to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a dashboard list
>
> **Slug:** `DATADOG_GET_DASHBOARD_LIST`
>
> Fetch an existing dashboard list definition by ID. Uses GET /api/v1/dashboard/lists/manual/\{list\_id}. Datadog permission(s): dashboards\_read.
>
> #### Input Parameters
>
> **list\_id** `integer` *required*
>
> ID of the dashboard list to fetch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get items of a Dashboard List
>
> **Slug:** `DATADOG_GET_DASHBOARD_LIST_ITEMS`
>
> Fetch 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
>
> **dashboard\_list\_id** `integer` *required*
>
> ID of the dashboard list to get items from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a derived metric
>
> **Slug:** `DATADOG_GET_DERIVED_METRIC`
>
> Get the definition of a derived metric by name. Uses GET /api/v2/metrics/derived-metrics/\{metric\_name}. Datadog permission(s): metrics\_read.
>
> #### Input Parameters
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a downtime
>
> **Slug:** `DATADOG_GET_DOWNTIME`
>
> Get downtime detail by downtime\_id. Uses GET /api/v2/downtime/\{downtime\_id}. Datadog permission(s): monitors\_downtime.
>
> #### Input Parameters
>
> **include** `string`
>
> Comma-separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `monitor`.
>
> **downtime\_id** `string` *required*
>
> ID of the downtime to fetch.
>
> **with\_run\_as** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get On-Call escalation policy
>
> **Slug:** `DATADOG_GET_ESCALATION_POLICY`
>
> Retrieves a Datadog On-Call escalation policy by ID.
>
> #### Input Parameters
>
> **policy\_id** `string` *required*
>
> Unique identifier of the On-Call escalation policy to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get an event
>
> **Slug:** `DATADOG_GET_EVENT`
>
> Get event details by event ID using GET /api/v1/events/\{event\_id}. Datadog permission(s): events\_read.
>
> #### Input Parameters
>
> **event\_id** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get an event
>
> **Slug:** `DATADOG_GET_EVENT_V2`
>
> Get the details of an event by event\_id. Uses GET /api/v2/events/\{event\_id}. Datadog permission(s): events\_read.
>
> #### Input Parameters
>
> **event\_id** `string` *required*
>
> The UID of the event.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a global variable
>
> **Slug:** `DATADOG_GET_GLOBAL_VARIABLE`
>
> Get 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
>
> **variable\_id** `string` *required*
>
> The ID of the global variable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get hourly usage
>
> **Slug:** `DATADOG_GET_HOURLY_USAGE`
>
> Gets hourly Datadog usage records for product families and a UTC hour range.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of records to return, from 1 to 500.
>
> **end\_time** `string`
>
> Exclusive UTC end hour in ISO-8601 format.
>
> **versions** `string`
>
> Comma-separated product family versions, such as infra\_hosts:1.0.0.
>
> **start\_time** `string` *required*
>
> Inclusive UTC start hour in ISO-8601 format, such as 2026-10-01T00.
>
> **next\_record\_id** `string`
>
> Cursor returned in meta.pagination.next\_record\_id by the previous page.
>
> **product\_families** `string` *required*
>
> Comma-separated product families to return, or 'all'.
>
> **include\_breakdown** `boolean`
>
> Whether to include usage subcategory breakdowns where available.
>
> **include\_descendants** `boolean`
>
> Whether to include usage from child organizations.
>
> **include\_connected\_accounts** `boolean`
>
> Whether to include usage from connected partner accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get metric metadata
>
> **Slug:** `DATADOG_GET_METRIC_METADATA`
>
> Get metadata for a specific metric using GET /api/v1/metrics/\{metric\_name}. Datadog permission(s): metrics\_read.
>
> #### Input Parameters
>
> **metric\_name** `string` *required*
>
> Name of the metric for which to get metadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get tag key cardinality details
>
> **Slug:** `DATADOG_GET_METRIC_TAG_CARDINALITY_DETAILS`
>
> Get tag key cardinality details for a specific metric. Uses GET /api/v2/metrics/\{metric\_name}/tag-cardinalities. Datadog permission(s): metrics\_read.
>
> #### Input Parameters
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a mobile test
>
> **Slug:** `DATADOG_GET_MOBILE_TEST`
>
> Get the detailed configuration of a Synthetic mobile test. Uses GET /api/v1/synthetics/tests/mobile/\{public\_id}. Datadog permission(s): synthetics\_read.
>
> #### Input Parameters
>
> **public\_id** `string` *required*
>
> The public ID of the test to get details from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get monitor
>
> **Slug:** `DATADOG_GET_MONITOR`
>
> Retrieves detailed information about a specific Datadog monitor, including its current state, configuration, and any active downtimes.
>
> #### Input Parameters
>
> **monitor\_id** `integer` *required*
>
> The ID of the monitor to retrieve Use DATADOG\_LIST\_MONITORS to discover valid integer IDs if unknown.
>
> **group\_states** `array`
>
> Filter by group states when retrieving monitor details. Valid values: 'all', 'alert', 'warn', 'no data'
>
> **with\_downtimes** `boolean`
>
> Include downtime information in the response
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a monitor configuration policy
>
> **Slug:** `DATADOG_GET_MONITOR_CONFIG_POLICY`
>
> Get a monitor configuration policy by policy\_id. Uses GET /api/v2/monitor/policy/\{policy\_id}. Datadog permission(s): monitors\_read.
>
> #### Input Parameters
>
> **policy\_id** `string` *required*
>
> ID of the monitor configuration policy.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a monitor notification rule
>
> **Slug:** `DATADOG_GET_MONITOR_NOTIFICATION_RULE`
>
> Get 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
>
> **include** `string`
>
> Comma-separated list of resource paths for related resources to include in the response. Supported resource path is `created_by`.
>
> **rule\_id** `string` *required*
>
> ID of the monitor notification rule to fetch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all monitor notification rules
>
> **Slug:** `DATADOG_GET_MONITOR_NOTIFICATION_RULES`
>
> Get 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
>
> **page** `integer`
>
> The page to start paginating from. If `page` is not specified, the argument defaults to the first page.
>
> **sort** `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`.
>
> **filters** `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.
>
> **include** `string`
>
> Comma-separated list of resource paths for related resources to include in the response. Supported resource path is `created_by`.
>
> **per\_page** `integer`
>
> The number of rules to return per page. If `per_page` is not specified, the argument defaults to 100.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a notebook
>
> **Slug:** `DATADOG_GET_NOTEBOOK`
>
> Get a notebook using its notebook ID. Uses GET /api/v1/notebooks/\{notebook\_id}. Datadog permission(s): notebooks\_read.
>
> #### Input Parameters
>
> **notebook\_id** `integer` *required*
>
> Unique ID, assigned when you create the notebook.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get On-Call notification channel
>
> **Slug:** `DATADOG_GET_NOTIFICATION_CHANNEL`
>
> Retrieves an On-Call notification channel for a user by ID.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> Unique identifier of the user whose On-Call notification channel you want to retrieve.
>
> **channel\_id** `string` *required*
>
> Unique identifier of the On-Call notification channel to retrieve for the user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get On-Call notification rule
>
> **Slug:** `DATADOG_GET_NOTIFICATION_RULE`
>
> Retrieves an On-Call notification rule for a user by ID.
>
> #### Input Parameters
>
> **rule\_id** `string` *required*
>
> Unique identifier of the On-Call notification rule to retrieve for the user.
>
> **user\_id** `string` *required*
>
> Unique identifier of the user whose On-Call notification rule should be fetched.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get the on-demand concurrency cap
>
> **Slug:** `DATADOG_GET_ON_DEMAND_CONCURRENCY_CAP`
>
> Get the on-demand concurrency cap. Uses GET /api/v2/synthetics/settings/on\_demand\_concurrency\_cap. Datadog permission(s): billing\_read.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a private location
>
> **Slug:** `DATADOG_GET_PRIVATE_LOCATION`
>
> Get 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
>
> **location\_id** `string` *required*
>
> The ID of the private location.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a shared dashboard
>
> **Slug:** `DATADOG_GET_PUBLIC_DASHBOARD`
>
> Fetch 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
>
> **token** `string` *required*
>
> The token of the shared dashboard. Generated when a dashboard is shared.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all invitations for a shared dashboard
>
> **Slug:** `DATADOG_GET_PUBLIC_DASHBOARD_INVITATIONS`
>
> Get 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
>
> **token** `string` *required*
>
> Token of the shared dashboard for which to fetch invitations.
>
> **page\_size** `integer`
>
> The number of records to return in a single request.
>
> **page\_number** `integer`
>
> The page to access (base 0).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get On-Call schedule
>
> **Slug:** `DATADOG_GET_SCHEDULE`
>
> Retrieves a Datadog On-Call schedule by ID.
>
> #### Input Parameters
>
> **schedule\_id** `string` *required*
>
> Unique identifier of the On-Call schedule to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get scheduled on-call user
>
> **Slug:** `DATADOG_GET_SCHEDULED_ON_CALL_USER`
>
> Gets the currently scheduled on-call user for a Datadog On-Call schedule using a deprecated Datadog endpoint.
>
> #### Input Parameters
>
> **schedule\_id** `string` *required*
>
> Unique identifier of the On-Call schedule whose currently scheduled on-call user you want to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get on-call responders for a schedule
>
> **Slug:** `DATADOG_GET_SCHEDULE_ON_CALL_RESPONDERS`
>
> Get 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
>
> **include** `string`
>
> Comma-separated list of included relationships to be returned. Allowed values: `schedule`, `responders`, `responders.shifts`, `responders.shifts.user`.
>
> **schedule\_id** `string` *required*
>
> The ID of the schedule.
>
> **filter\_at\_ts** `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.
>
> **filter\_position** `string`
>
> Comma-separated list of positions to retrieve. Allowed values: `previous`, `current`, `next`. Defaults to `current` if omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a single service definition
>
> **Slug:** `DATADOG_GET_SERVICE_DEFINITION`
>
> Get 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
>
> **service\_name** `string` *required*
>
> The name of the service.
>
> **schema\_version** `string ("v1" | "v2" | "v2.1" | "v2.2")`
>
> Schema versions
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Service Dependencies
>
> **Slug:** `DATADOG_GET_SERVICE_DEPENDENCIES`
>
> Get 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
>
> **env** `string`
>
> Environment to filter by Strongly recommended: omitting this aggregates data across all environments, producing noisy results that obscure meaningful dependency relationships.
>
> **service** `string` *required*
>
> The service name to get dependencies for
>
> **end\_time** `integer`
>
> End time as UNIX timestamp (seconds)
>
> **start\_time** `integer`
>
> Start time as UNIX timestamp (seconds)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get an SLO's details
>
> **Slug:** `DATADOG_GET_SLO`
>
> Get 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
>
> **slo\_id** `string` *required*
>
> The ID of the service level objective object.
>
> **with\_configured\_alert\_ids** `boolean`
>
> Get the IDs of SLO monitors that reference this SLO.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Corrections For an SLO
>
> **Slug:** `DATADOG_GET_SLO_CORRECTIONS`
>
> Get corrections applied to an SLO. Uses GET /api/v1/slo/\{slo\_id}/corrections. Datadog permission(s): slos\_read.
>
> #### Input Parameters
>
> **slo\_id** `string` *required*
>
> The ID of the service level objective object.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get an SLO's history
>
> **Slug:** `DATADOG_GET_SLO_HISTORY`
>
> Get 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
>
> **to\_ts** `integer` *required*
>
> The `to` timestamp for the query window in epoch seconds.
>
> **slo\_id** `string` *required*
>
> The ID of the service level objective object.
>
> **target** `number`
>
> The SLO target. If `target` is passed in, the response will include the remaining error budget and a timeframe value of `custom`.
>
> **from\_ts** `integer` *required*
>
> The `from` timestamp for the query window in epoch seconds.
>
> **apply\_correction** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a browser test result
>
> **Slug:** `DATADOG_GET_SYNTHETICS_BROWSER_TEST_RESULT`
>
> Get 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
>
> **event\_id** `string`
>
> The event ID used to look up the result in the event store.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic browser test to which the target result belongs.
>
> **result\_id** `string` *required*
>
> The ID of the result to get.
>
> **timestamp** `integer`
>
> Timestamp in seconds to look up the result.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get details of batch
>
> **Slug:** `DATADOG_GET_SYNTHETICS_CI_BATCH`
>
> Get updated details of a batch. Uses GET /api/v1/synthetics/ci/batch/\{batch\_id}. Datadog permission(s): synthetics\_read.
>
> #### Input Parameters
>
> **batch\_id** `string` *required*
>
> The ID of the batch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get the default locations
>
> **Slug:** `DATADOG_GET_SYNTHETICS_DEFAULT_LOCATIONS`
>
> Get 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a Synthetics downtime
>
> **Slug:** `DATADOG_GET_SYNTHETICS_DOWNTIME`
>
> Get a Synthetics downtime by its ID. Uses GET /api/v2/synthetics/downtimes/\{downtime\_id}. Datadog permission(s): synthetics\_read.
>
> #### Input Parameters
>
> **downtime\_id** `string` *required*
>
> The ID of the downtime to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a fast test result
>
> **Slug:** `DATADOG_GET_SYNTHETICS_FAST_TEST_RESULT`
>
> Read 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
>
> **id** `string` *required*
>
> The UUID of the fast test to retrieve the result for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Synthetics Locations
>
> **Slug:** `DATADOG_GET_SYNTHETICS_LOCATIONS`
>
> Tool 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a Network Path test
>
> **Slug:** `DATADOG_GET_SYNTHETICS_NETWORK_TEST`
>
> Get a Network Path test by its public ID. Uses GET /api/v2/synthetics/tests/network/\{public\_id}. Datadog permission(s): synthetics\_read.
>
> #### Input Parameters
>
> **public\_id** `string` *required*
>
> The public ID of the Network Path test to get details from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a suite
>
> **Slug:** `DATADOG_GET_SYNTHETICS_SUITE`
>
> Get a Synthetics suite by its public ID. Uses GET /api/v2/synthetics/suites/\{public\_id}. Datadog permission(s): synthetics\_read.
>
> #### Input Parameters
>
> **public\_id** `string` *required*
>
> The public ID of the suite to get details from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a test result
>
> **Slug:** `DATADOG_GET_SYNTHETICS_TEST_RESULT`
>
> Get 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
>
> **event\_id** `string`
>
> The event ID used to look up the result in the event store.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test to which the target result belongs.
>
> **result\_id** `string` *required*
>
> The ID of the result to get.
>
> **timestamp** `integer`
>
> Timestamp in seconds to look up the result.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a specific version of a test
>
> **Slug:** `DATADOG_GET_SYNTHETICS_TEST_VERSION`
>
> Get 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
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test.
>
> **version\_number** `integer` *required*
>
> The version number to retrieve.
>
> **only\_check\_existence** `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.
>
> **include\_change\_metadata** `boolean`
>
> If `true`, include change metadata in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get host tags
>
> **Slug:** `DATADOG_GET_TAGS`
>
> Retrieves tags associated with a specific host in Datadog, optionally filtered by tag source. Useful for understanding host metadata and organizing infrastructure.
>
> #### Input Parameters
>
> **source** `string`
>
> Source of tags to retrieve (e.g., 'users', 'chef', 'puppet')
>
> **host\_name** `string` *required*
>
> Name of the host to get tags from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get team on-call users
>
> **Slug:** `DATADOG_GET_TEAM_ON_CALL_USERS`
>
> Gets the current on-call users for a Datadog On-Call team.
>
> #### Input Parameters
>
> **team\_id** `string` *required*
>
> Unique identifier of the team whose current on-call users you want to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get On-Call team routing rules
>
> **Slug:** `DATADOG_GET_TEAM_ROUTING_RULES`
>
> Gets the Datadog On-Call routing rules configured for a team.
>
> #### Input Parameters
>
> **team\_id** `string` *required*
>
> Unique identifier of the On-Call team whose routing rules you want to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a test configuration
>
> **Slug:** `DATADOG_GET_TEST`
>
> Get the detailed configuration associated with a Synthetic test. Uses GET /api/v1/synthetics/tests/\{public\_id}. Datadog permission(s): synthetics\_read.
>
> #### Input Parameters
>
> **public\_id** `string` *required*
>
> The public ID of the test to get details from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a presigned URL for downloading a test file
>
> **Slug:** `DATADOG_GET_TEST_FILE_DOWNLOAD_URL`
>
> Get 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
>
> **body** `object` *required*
>
> The documented request body.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get presigned URLs for uploading a test file
>
> **Slug:** `DATADOG_GET_TEST_FILE_MULTIPART_PRESIGNED_URLS`
>
> Initiate 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
>
> **body** `object` *required*
>
> The documented request body.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get parent suites for a test
>
> **Slug:** `DATADOG_GET_TEST_PARENT_SUITES`
>
> Get 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
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Trace by ID
>
> **Slug:** `DATADOG_GET_TRACE_BY_ID`
>
> Search 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
>
> **to\_time** `string`
>
> End time for the search window. Supports ISO8601, date math (e.g., 'now'), or timestamps in milliseconds. Defaults to current time.
>
> **trace\_id** `string` *required*
>
> The unique trace ID to retrieve
>
> **from\_time** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get usage summary
>
> **Slug:** `DATADOG_GET_USAGE_SUMMARY`
>
> Retrieves 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
>
> **end\_month** `string`
>
> End month in YYYY-MM format. If not provided, uses start\_month
>
> **start\_month** `string` *required*
>
> Start month in YYYY-MM format
>
> **include\_org\_details** `boolean`
>
> Include organization details in the response
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user
>
> **Slug:** `DATADOG_GET_USER`
>
> Retrieve one Datadog organization user by ID, including related resources.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> ID of the Datadog user to retrieve. Use DATADOG\_LIST\_USERS to discover it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a webhook integration
>
> **Slug:** `DATADOG_GET_WEBHOOKS_INTEGRATION`
>
> Get 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
>
> **webhook\_name** `string` *required*
>
> The name of the webhook.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List active tags and aggregations
>
> **Slug:** `DATADOG_LIST_ACTIVE_METRIC_CONFIGURATIONS`
>
> List 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
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> **window\_seconds** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Tags
>
> **Slug:** `DATADOG_LIST_ALL_TAGS`
>
> List Datadog host tags, optionally filtered by source. Tags help organize and filter infrastructure.
>
> #### Input Parameters
>
> **source** `string`
>
> Filter tags by source (e.g., 'chef', 'puppet', 'users', 'datadog')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List API Keys
>
> **Slug:** `DATADOG_LIST_API_KEYS`
>
> List 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
>
> **sort** `string ("created_at" | "last4" | "modified_at" | "name")`
>
> Sort field.
>
> **page\_size** `integer`
>
> Number of API keys to return per page (default 20, max 1000)
>
> **page\_number** `integer`
>
> Page number to retrieve (0-indexed)
>
> **filter\_created\_at\_end** `string`
>
> ISO timestamp to filter keys created before this time
>
> **filter\_modified\_at\_end** `string`
>
> ISO timestamp to filter keys modified before this time
>
> **filter\_created\_at\_start** `string`
>
> ISO timestamp to filter keys created after this time
>
> **filter\_modified\_at\_start** `string`
>
> ISO timestamp to filter keys modified after this time
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List APM Services
>
> **Slug:** `DATADOG_LIST_APM_SERVICES`
>
> List Datadog APM services, optionally filtering by environment. Use '\*' to include services across environments.
>
> #### Input Parameters
>
> **env** `string`
>
> Environment filter (e.g., 'production', 'staging'). Use '\*' to return services across all environments.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List all AWS integrations
>
> **Slug:** `DATADOG_LIST_AWS_ACCOUNTS`
>
> List 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
>
> **aws\_account\_id** `string`
>
> Optional query parameter to filter accounts by AWS Account ID. If not provided, all accounts are returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List AWS Integration
>
> **Slug:** `DATADOG_LIST_AWS_INTEGRATION`
>
> List 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
>
> **role\_name** `string`
>
> Filter by specific AWS IAM role name
>
> **account\_id** `string`
>
> Filter by specific AWS account ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a list of entities
>
> **Slug:** `DATADOG_LIST_CATALOG_ENTITY`
>
> Get a list of entities. Uses GET /api/v2/catalog/entity. Returns one page; pass the documented pagination fields to continue.
>
> #### Input Parameters
>
> **include** `string ("schema" | "raw_schema" | "oncall" | "incident" | "relation")`
>
> Supported include types.
>
> **filter\_id** `string`
>
> Filter entities by UUID.
>
> **filter\_ref** `string`
>
> Filter entities by reference
>
> **page\_limit** `integer`
>
> Maximum number of entities in the response.
>
> **filter\_kind** `string`
>
> Filter entities by kind.
>
> **filter\_name** `string`
>
> Filter entities by name.
>
> **page\_offset** `integer`
>
> Specific offset to use as the beginning of the returned page.
>
> **filter\_owner** `string`
>
> Filter entities by owner.
>
> **includeDiscovered** `boolean`
>
> If true, includes discovered services from APM and USM that do not have entity definitions.
>
> **filter\_relation\_type** `string ("RelationTypeOwns" | "RelationTypeOwnedBy" | "RelationTypeDependsOn" | "RelationTypeDependencyOf" | "RelationTypePartsOf" | "RelationTypeHasPart" | "RelationTypeOtherOwns" | "RelationTypeOtherOwnedBy" | "RelationTypeImplementedBy" | "RelationTypeImplements")`
>
> Supported relation types.
>
> **filter\_exclude\_snapshot** `string`
>
> Filter entities by excluding snapshotted entities.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a list of entity kinds
>
> **Slug:** `DATADOG_LIST_CATALOG_KIND`
>
> Get a list of entity kinds. Uses GET /api/v2/catalog/kind. Returns one page; pass the documented pagination fields to continue.
>
> #### Input Parameters
>
> **filter\_id** `string`
>
> Filter entities by UUID.
>
> **page\_limit** `integer`
>
> Maximum number of kinds in the response.
>
> **filter\_name** `string`
>
> Filter entities by name.
>
> **page\_offset** `integer`
>
> Specific offset to use as the beginning of the returned page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a list of entity relations
>
> **Slug:** `DATADOG_LIST_CATALOG_RELATION`
>
> Get a list of entity relations. Uses GET /api/v2/catalog/relation. Returns one page; pass the documented pagination fields to continue.
>
> #### Input Parameters
>
> **include** `string ("entity" | "schema")`
>
> Supported include types for relations.
>
> **page\_limit** `integer`
>
> Maximum number of relations in the response.
>
> **filter\_type** `string ("RelationTypeOwns" | "RelationTypeOwnedBy" | "RelationTypeDependsOn" | "RelationTypeDependencyOf" | "RelationTypePartsOf" | "RelationTypeHasPart" | "RelationTypeOtherOwns" | "RelationTypeOtherOwnedBy" | "RelationTypeImplementedBy" | "RelationTypeImplements")`
>
> Supported relation types.
>
> **page\_offset** `integer`
>
> Specific offset to use as the beginning of the returned page.
>
> **filter\_to\_ref** `string`
>
> Filter relations by the reference of the second entity in the relation.
>
> **filter\_from\_ref** `string`
>
> Filter relations by the reference of the first entity in the relation.
>
> **includeDiscovered** `boolean`
>
> If true, includes relationships discovered by APM and USM.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all dashboard lists
>
> **Slug:** `DATADOG_LIST_DASHBOARD_LISTS`
>
> Fetch all existing dashboard list definitions. Uses GET /api/v1/dashboard/lists/manual without pagination parameters. Required Datadog permission: dashboards\_read.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List dashboards
>
> **Slug:** `DATADOG_LIST_DASHBOARDS`
>
> Lists 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
>
> **count** `integer`
>
> Maximum number of dashboards to return (for pagination)
>
> **start** `integer`
>
> Offset for pagination; skip this many dashboards before returning results
>
> **filter\_shared** `boolean`
>
> Filter dashboards by shared status
>
> **filter\_deleted** `boolean`
>
> Include deleted dashboards in the results
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all downtimes
>
> **Slug:** `DATADOG_LIST_DOWNTIMES`
>
> Get all downtimes. Uses GET /api/v2/downtime. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): monitors\_downtime.
>
> #### Input Parameters
>
> **include** `string`
>
> Comma-separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `monitor`.
>
> **page\_limit** `integer`
>
> Maximum number of downtimes in the response.
>
> **page\_offset** `integer`
>
> Specific offset to use as the beginning of the returned page.
>
> **current\_only** `boolean`
>
> Only return downtimes that are active when the request is made.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List events
>
> **Slug:** `DATADOG_LIST_EVENTS`
>
> Lists 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
>
> **end** `integer` *required*
>
> End time as UNIX timestamp
>
> **page** `integer`
>
> Page number for pagination
>
> **tags** `array`
>
> Filter by tags
>
> **start** `integer` *required*
>
> Start time as UNIX timestamp
>
> **sources** `string`
>
> Filter by event sources (comma-separated)
>
> **priority** `string ("normal" | "low")`
>
> Filter by event priority.
>
> **unaggregated** `boolean`
>
> Get unaggregated events (default: false)
>
> **exclude\_aggregate** `boolean`
>
> Exclude aggregated events
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a list of events
>
> **Slug:** `DATADOG_LIST_EVENTS_V2`
>
> Get 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
>
> **sort** `string ("timestamp" | "-timestamp")`
>
> The sort parameters when querying events.
>
> **filter\_to** `string`
>
> Maximum timestamp for requested events, in milliseconds.
>
> **page\_limit** `integer`
>
> Maximum number of events in the response.
>
> **filter\_from** `string`
>
> Minimum timestamp for requested events, in milliseconds.
>
> **page\_cursor** `string`
>
> List following results with a cursor provided in the previous query.
>
> **filter\_query** `string`
>
> Search query following events syntax.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all global variables
>
> **Slug:** `DATADOG_LIST_GLOBAL_VARIABLES`
>
> Get all Synthetic global variables. Uses GET /api/v1/synthetics/variables. Requires either synthetics\_global\_variable\_read or apm\_api\_catalog\_read permission.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List hosts
>
> **Slug:** `DATADOG_LIST_HOSTS`
>
> Lists 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
>
> **count** `integer`
>
> Number of hosts to return (max 1000)
>
> **start** `integer`
>
> Starting position for pagination
>
> **filter** `string`
>
> Filter hosts by tags or attributes
>
> **sort\_dir** `string ("asc" | "desc")`
>
> Sort direction.
>
> **sort\_field** `string ("status" | "name" | "cpu" | "iowait" | "load")`
>
> Field to sort by.
>
> **from\_timestamp** `integer`
>
> Start time as UNIX timestamp for host activity
>
> **include\_hosts\_metadata** `boolean`
>
> Include hosts metadata in response
>
> **include\_muted\_hosts\_data** `boolean`
>
> Include data for muted hosts
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List an incident's impacts
>
> **Slug:** `DATADOG_LIST_INCIDENT_IMPACTS`
>
> List 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
>
> **include** `array`
>
> Specifies which related resources should be included in the response.
>
> **incident\_id** `string` *required*
>
> The UUID of the incident.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Incidents
>
> **Slug:** `DATADOG_LIST_INCIDENTS`
>
> List 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
>
> **sort** `string ("public_id" | "-public_id")`
>
> Sort order for incidents by public ID.
>
> **include** `string`
>
> Related resources to include (e.g., 'users,attachments')
>
> **page\_size** `integer`
>
> Number of incidents per page (1-100, default: 25)
>
> **page\_offset** `integer`
>
> Page offset for pagination (default: 0)
>
> **filter\_query** `string`
>
> Filter query for incidents (e.g., 'state:active')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Log Indexes
>
> **Slug:** `DATADOG_LIST_LOG_INDEXES`
>
> Tool 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search logs (GET)
>
> **Slug:** `DATADOG_LIST_LOGS`
>
> Search 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
>
> **sort** `string ("timestamp" | "-timestamp")`
>
> Sort parameters when querying logs.
>
> **filter\_to** `string`
>
> Maximum timestamp for requested logs.
>
> **page\_limit** `integer`
>
> Maximum number of logs in the response.
>
> **filter\_from** `string`
>
> Minimum timestamp for requested logs.
>
> **page\_cursor** `string`
>
> List following results with a cursor provided in the previous query.
>
> **filter\_query** `string`
>
> Search query following logs syntax.
>
> **filter\_indexes** `array`
>
> For customers with multiple indexes, the indexes to search. Defaults to '\*' which means all indexes
>
> **filter\_storage\_tier** `string ("indexes" | "online-archives" | "flex")`
>
> Specifies storage type as indexes, online-archives or flex
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Related Assets to a Metric
>
> **Slug:** `DATADOG_LIST_METRIC_ASSETS`
>
> Returns dashboards, monitors, notebooks, and SLOs containing a metric. Updated every 24 hours. Uses GET /api/v2/metrics/\{metric\_name}/assets.
>
> #### Input Parameters
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List active metrics
>
> **Slug:** `DATADOG_LIST_METRICS`
>
> Discover 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
>
> **host** `string`
>
> Hostname for filtering the list of metrics returned. If set, metrics retrieved are those with the corresponding hostname tag.
>
> **tag\_filter** `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.
>
> **from\_timestamp** `integer` *required*
>
> Seconds since Unix epoch. Specifies the starting point for listing actively reporting metrics.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a list of metrics
>
> **Slug:** `DATADOG_LIST_METRIC_TAG_CONFIGURATIONS`
>
> Get 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
>
> **sort** `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]`).
>
> **include** `string`
>
> Include related resources in the response. Set to `metric_volumes` to include indexed and ingested volume counts for each metric.
>
> **page\_size** `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.
>
> **filter\_tags** `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*`.
>
> **page\_cursor** `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.
>
> **filter\_queried** `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.
>
> **window\_seconds** `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.
>
> **filter\_configured** `boolean`
>
> Only return custom metrics that have been configured (`true`) or not configured (`false`) with Metrics Without Limits.
>
> **filter\_metric\_type** `string ("non_distribution" | "distribution" | "exponential_histogram" | "explicit_histogram")`
>
> The metric's type category.
>
> **filter\_related\_assets** `boolean`
>
> Only return metrics that are used in at least one dashboard, monitor, notebook, or SLO.
>
> **filter\_is\_configurable** `boolean`
>
> Only return metrics that are eligible (`true`) or ineligible (`false`) for configuration with Metrics Without Limits.
>
> **filter\_tags\_configured** `string`
>
> Only return metrics that have the given tag key(s) in their Metrics Without Limits configuration (included or excluded).
>
> **filter\_include\_percentiles** `boolean`
>
> Only return distribution metrics that have percentile aggregations enabled (true) or disabled (false).
>
> **filter\_queried\_window\_seconds** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List metric tags
>
> **Slug:** `DATADOG_LIST_METRIC_TAGS`
>
> List indexed and ingested tags observed for one Datadog metric.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of tags to return, from 1 through 1000000.
>
> **filter\_tags** `string`
>
> Comma-separated tags that data points must contain, such as env:staging,host:123.
>
> **metric\_name** `string` *required*
>
> Name of the metric whose observed tags are returned.
>
> **filter\_match** `string`
>
> Text used to match tag keys or values.
>
> **allow\_partial** `boolean`
>
> Whether Datadog may return partial results when all tags are unavailable.
>
> **window\_seconds** `integer`
>
> Lookback window in seconds. Datadog requires at least 14400 seconds.
>
> **include\_tag\_values** `boolean`
>
> Whether to include tag values in the returned tags.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all monitor configuration policies
>
> **Slug:** `DATADOG_LIST_MONITOR_CONFIG_POLICIES`
>
> Get all monitor configuration policies. Uses GET /api/v2/monitor/policy. Datadog permission(s): monitors\_read.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get active downtimes for a monitor
>
> **Slug:** `DATADOG_LIST_MONITOR_DOWNTIMES`
>
> Get 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
>
> **monitor\_id** `integer` *required*
>
> The id of the monitor.
>
> **page\_limit** `integer`
>
> Maximum number of downtimes in the response.
>
> **page\_offset** `integer`
>
> Specific offset to use as the beginning of the returned page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List monitors
>
> **Slug:** `DATADOG_LIST_MONITORS`
>
> List 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
>
> **name** `string`
>
> Filter monitors by name (substring match)
>
> **page** `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.
>
> **tags** `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.
>
> **id\_offset** `integer`
>
> Monitor ID offset for pagination
>
> **page\_size** `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.
>
> **group\_states** `array`
>
> When specified, shows additional information about the group states. Choose one or more from Alert, Warn, or No Data.
>
> **monitor\_tags** `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.
>
> **with\_downtimes** `boolean`
>
> If this argument is set to true, then the returned data includes all current downtimes for the monitor.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all notebooks
>
> **Slug:** `DATADOG_LIST_NOTEBOOKS`
>
> Get all notebooks. Uses GET /api/v1/notebooks. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): notebooks\_read.
>
> #### Input Parameters
>
> **type** `string`
>
> If type is provided, returns only notebooks with that metadata type. Default does not have type filtering.
>
> **count** `integer`
>
> The number of notebooks to be returned.
>
> **query** `string`
>
> Return only notebooks with `query` string in notebook name or author handle.
>
> **start** `integer`
>
> The index of the first notebook you want returned.
>
> **sort\_dir** `string`
>
> Sort by direction `asc` or `desc`.
>
> **sort\_field** `string`
>
> Sort by field `modified`, `name`, or `created`.
>
> **is\_template** `boolean`
>
> True value returns only template notebooks. Default is false (returns only non-template notebooks).
>
> **author\_handle** `string`
>
> Return notebooks created by the given `author_handle`.
>
> **include\_cells** `boolean`
>
> Value of `false` excludes the `cells` and global `time` for each notebook.
>
> **exclude\_author\_handle** `string`
>
> Return notebooks not created by the given `author_handle`.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List On-Call notification channels
>
> **Slug:** `DATADOG_LIST_NOTIFICATION_CHANNELS`
>
> Lists the On-Call notification channels configured for a Datadog user.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> Unique identifier of the Datadog user whose On-Call notification channels to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List On-Call notification rules
>
> **Slug:** `DATADOG_LIST_NOTIFICATION_RULES`
>
> Lists the On-Call notification rules configured for a Datadog user.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> Unique identifier of the Datadog user whose On-Call notification rules to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List On-Call schedules
>
> **Slug:** `DATADOG_LIST_ON_CALL_SCHEDULES`
>
> List 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
>
> **include** `string`
>
> Comma-separated list of included relationships to be returned. Allowed value: `teams`.
>
> **page\_size** `integer`
>
> Number of items to return per page. The maximum allowed value is 100.
>
> **page\_number** `integer`
>
> Specific page number to return.
>
> **filter\_query** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organizations
>
> **Slug:** `DATADOG_LIST_ORGANIZATIONS`
>
> List top-level Datadog organization metadata visible to the account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Roles
>
> **Slug:** `DATADOG_LIST_ROLES`
>
> List roles from Datadog organization. Roles define sets of permissions that control what users can do within your Datadog organization.
>
> #### Input Parameters
>
> **sort** `string`
>
> Sort field (name, created\_at, user\_count)
>
> **page\_size** `integer`
>
> Number of roles per page (1-100, default: 10)
>
> **filter\_name** `string`
>
> Filter roles by name (partial match)
>
> **page\_number** `integer`
>
> Page number for pagination (default: 0)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List On-Call schedule overrides
>
> **Slug:** `DATADOG_LIST_SCHEDULE_OVERRIDES`
>
> List 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
>
> **include** `string`
>
> Comma-separated list of related resources to include in the response. Allowed values: `user`, `overridden_user`, `user.color`.
>
> **page\_size** `integer`
>
> Number of overrides to return per page. The maximum allowed value is 50.
>
> **filter\_end** `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.
>
> **page\_number** `integer`
>
> Specific page number to return.
>
> **schedule\_id** `string` *required*
>
> The ID of the schedule.
>
> **filter\_start** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List service checks
>
> **Slug:** `DATADOG_LIST_SERVICE_CHECKS`
>
> Lists service checks from Datadog. Service checks are status checks that track the health of your services and infrastructure components.
>
> #### Input Parameters
>
> **end** `integer`
>
> End time as UNIX timestamp
>
> **tags** `array`
>
> Filter by tags
>
> **check** `string`
>
> Filter by service check name
>
> **start** `integer`
>
> Start time as UNIX timestamp
>
> **status** `string ("ok" | "warning" | "critical" | "unknown")`
>
> Filter by service check status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List service definitions
>
> **Slug:** `DATADOG_LIST_SERVICE_DEFINITIONS`
>
> Page through service definitions in the Datadog Service Catalog.
>
> #### Input Parameters
>
> **page\_size** `integer`
>
> Number of service definitions to return; use at most 100 (provider default: 10).
>
> **page\_number** `integer`
>
> Zero-based page number to return (provider default: 0).
>
> **schema\_version** `string ("v1" | "v2" | "v2.1" | "v2.2")`
>
> Service definition schema version desired in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List SLOs
>
> **Slug:** `DATADOG_LIST_SL_OS`
>
> List 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
>
> **tags** `string`
>
> Filter SLOs by tags using a comma-separated list (e.g., 'env:prod,team:backend')
>
> **limit** `integer`
>
> Maximum number of SLOs to return (1-1000, default: 25)
>
> **query** `string`
>
> Search query to filter SLOs by name or description
>
> **offset** `integer`
>
> Number of SLOs to skip for pagination (default: 0)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List span-based metrics
>
> **Slug:** `DATADOG_LIST_SPAN_METRICS`
>
> List configured Datadog span-based metrics and their definitions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search spans
>
> **Slug:** `DATADOG_LIST_SPANS`
>
> Search spans. Uses POST /api/v2/spans/events/search. Supply the documented payload in body.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> The documented request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Synthetics Tests
>
> **Slug:** `DATADOG_LIST_SYNTHETICS`
>
> List 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
>
> **tags** `string`
>
> Filter tests by tags using a comma-separated list (e.g., 'env:prod,team:frontend')
>
> **limit** `integer`
>
> Maximum number of tests to return (1-200, default: 50)
>
> **offset** `integer`
>
> Zero-based page number for pagination (default: 0). Page 0 returns first page, page 1 returns second page, etc.
>
> **locations** `string`
>
> Filter tests by locations using a comma-separated list
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a browser test's latest results
>
> **Slug:** `DATADOG_LIST_SYNTHETICS_BROWSER_TEST_LATEST_RESULTS`
>
> Get 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
>
> **to\_ts** `integer`
>
> Timestamp in milliseconds up to which to query results.
>
> **status** `string ("passed" | "failed" | "no_data")`
>
> Status of a Synthetic test result.
>
> **from\_ts** `integer`
>
> Timestamp in milliseconds from which to start querying results.
>
> **runType** `string ("scheduled" | "fast" | "ci" | "triggered")`
>
> The type of run for a Synthetic test result.
>
> **probe\_dc** `array`
>
> Locations for which to query results.
>
> **device\_id** `array`
>
> Device IDs for which to query results.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic browser test for which to search results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Synthetics downtimes
>
> **Slug:** `DATADOG_LIST_SYNTHETICS_DOWNTIMES`
>
> List 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
>
> **filter\_active** `string`
>
> If set to `true`, return only downtimes that are currently active.
>
> **filter\_test\_ids** `string`
>
> Comma-separated list of Synthetics test public IDs to filter downtimes by.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a test's latest results
>
> **Slug:** `DATADOG_LIST_SYNTHETICS_TEST_LATEST_RESULTS`
>
> Get 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
>
> **to\_ts** `integer`
>
> Timestamp in milliseconds up to which to query results.
>
> **status** `string ("passed" | "failed" | "no_data")`
>
> Status of a Synthetic test result.
>
> **from\_ts** `integer`
>
> Timestamp in milliseconds from which to start querying results.
>
> **runType** `string ("scheduled" | "fast" | "ci" | "triggered")`
>
> The type of run for a Synthetic test result.
>
> **probe\_dc** `array`
>
> Locations for which to query results.
>
> **device\_id** `array`
>
> Device IDs for which to query results.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test for which to search results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get version history of a test
>
> **Slug:** `DATADOG_LIST_SYNTHETICS_TEST_VERSIONS`
>
> Get 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
>
> **limit** `integer`
>
> Maximum number of version records to return per page.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test.
>
> **last\_version\_number** `integer`
>
> The version number of the last item from the previous page. Omit to get the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List tag configuration by name
>
> **Slug:** `DATADOG_LIST_TAG_CONFIGURATION_BY_NAME`
>
> Return 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
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Users
>
> **Slug:** `DATADOG_LIST_USERS`
>
> List users from Datadog organization. User management allows you to see team members, their roles, and access levels within your Datadog organization.
>
> #### Input Parameters
>
> **sort** `string`
>
> Sort field (name, email, status, created\_at)
>
> **sort\_dir** `string`
>
> Sort direction (asc or desc)
>
> **page\_size** `integer`
>
> Number of users per page (1-1000, default: 50)
>
> **page\_number** `integer`
>
> Page number for pagination (default: 0)
>
> **filter\_status** `string`
>
> Filter by user status (Active, Pending, Disabled)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List distinct metric volumes by metric name
>
> **Slug:** `DATADOG_LIST_VOLUMES_BY_METRIC_NAME`
>
> View 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
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> **window\_seconds** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Webhooks
>
> **Slug:** `DATADOG_LIST_WEBHOOKS`
>
> List 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
>
> **limit** `integer`
>
> Maximum number of webhooks to return (1-100, default: 50)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mute Monitor
>
> **Slug:** `DATADOG_MUTE_MONITOR`
>
> Mute 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
>
> **end** `integer`
>
> POSIX timestamp for when the mute should expire (optional, if not specified the monitor remains muted until manually unmuted)
>
> **override** `boolean`
>
> Whether to override existing mute settings
>
> **monitor\_id** `integer` *required*
>
> The ID of the monitor to mute
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch a global variable
>
> **Slug:** `DATADOG_PATCH_GLOBAL_VARIABLE`
>
> Patch 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
>
> **body** `object` *required*
>
> JSON Patch document with operations to apply.
>
> **variable\_id** `string` *required*
>
> The ID of the global variable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch a Synthetic test
>
> **Slug:** `DATADOG_PATCH_TEST`
>
> Patch a Synthetic test. Uses PATCH /api/v1/synthetics/tests/\{public\_id}. Supply the documented payload in body. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> [JSON Patch](https://jsonpatch.com/) compliant list of operations
>
> **public\_id** `string` *required*
>
> The public ID of the test to patch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch a test suite
>
> **Slug:** `DATADOG_PATCH_TEST_SUITE`
>
> Patch 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
>
> **body** `object` *required*
>
> JSON Patch document with operations to apply.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test suite to patch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Poll for test results
>
> **Slug:** `DATADOG_POLL_SYNTHETICS_TEST_RESULTS`
>
> Poll 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
>
> **result\_ids** `string` *required*
>
> A JSON-encoded array of result IDs to poll for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Preview catalog entities
>
> **Slug:** `DATADOG_PREVIEW_CATALOG_ENTITIES`
>
> Preview catalog entities. Uses POST /api/v2/catalog/entity/preview.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query metrics
>
> **Slug:** `DATADOG_QUERY_METRICS`
>
> Queries 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
>
> **query** `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.
>
> **to\_timestamp** `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.
>
> **from\_timestamp** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query scalar data
>
> **Slug:** `DATADOG_QUERY_SCALAR_DATA`
>
> Run Datadog formula queries and return aggregated scalar columns.
>
> #### Input Parameters
>
> **queries** `array` *required*
>
> Typed scalar queries selected by data\_source.
>
> **formulas** `array`
>
> Formulas over named queries, with optional result limits.
>
> **to\_timestamp** `integer` *required*
>
> Exclusive end of the query window as Unix epoch milliseconds.
>
> **from\_timestamp** `integer` *required*
>
> Inclusive start of the query window as Unix epoch milliseconds.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query timeseries data
>
> **Slug:** `DATADOG_QUERY_TIMESERIES_DATA`
>
> Runs Datadog multi-product formula queries and returns aligned timeseries values.
>
> #### Input Parameters
>
> **queries** `array` *required*
>
> Typed Datadog timeseries queries selected by data\_source.
>
> **formulas** `array`
>
> Formula expressions evaluated over named queries.
>
> **interval** `integer`
>
> Requested rollup interval in milliseconds. Datadog may increase this value.
>
> **to\_timestamp** `integer` *required*
>
> Exclusive end of the query window as a Unix epoch timestamp in milliseconds.
>
> **from\_timestamp** `integer` *required*
>
> Inclusive start of the query window as a Unix epoch timestamp in milliseconds.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove a test from a Synthetics downtime
>
> **Slug:** `DATADOG_REMOVE_TEST_FROM_SYNTHETICS_DOWNTIME`
>
> Remove a test from a Synthetics downtime. Uses DELETE /api/v2/synthetics/downtimes/\{downtime\_id}/tests/\{test\_id}. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **test\_id** `string` *required*
>
> The public ID of the Synthetics test to disassociate from the downtime.
>
> **downtime\_id** `string` *required*
>
> The ID of the downtime.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Resolve On-Call Page
>
> **Slug:** `DATADOG_RESOLVE_ON_CALL_PAGE`
>
> Resolve 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
>
> **page\_id** `string` *required*
>
> The page ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restore deleted dashboards
>
> **Slug:** `DATADOG_RESTORE_DASHBOARDS`
>
> Restore deleted dashboards. Uses PATCH /api/v1/dashboard. Supply the documented payload in body. Datadog permission(s): dashboards\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Restore dashboards request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Schedule downtime
>
> **Slug:** `DATADOG_SCHEDULE_DOWNTIME`
>
> Schedule 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
>
> **data** `object` *required*
>
> JSON:API downtime resource to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search audit logs
>
> **Slug:** `DATADOG_SEARCH_AUDIT_LOGS`
>
> Search Datadog Audit Trail events with filters and cursor pagination.
>
> #### Input Parameters
>
> **sort** `string ("timestamp" | "-timestamp")`
>
> Order events by ascending or descending timestamp.
>
> **limit** `integer`
>
> Maximum number of audit events to return; must not exceed 1000.
>
> **query** `string`
>
> Datadog Audit Trail search query.
>
> **cursor** `string`
>
> Cursor from meta.page.after in the previous response.
>
> **to\_time** `string`
>
> End time as date math or a millisecond timestamp string.
>
> **timezone** `string`
>
> Timezone used for date math; mutually exclusive with time\_offset.
>
> **from\_time** `string`
>
> Start time as date math or a millisecond timestamp string.
>
> **time\_offset** `integer`
>
> UTC offset in seconds; mutually exclusive with timezone.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search events
>
> **Slug:** `DATADOG_SEARCH_EVENTS`
>
> Searches Datadog Event Management events with filters and pagination.
>
> #### Input Parameters
>
> **sort** `string ("timestamp" | "-timestamp")`
>
> Sort events by timestamp in ascending or descending order.
>
> **limit** `integer`
>
> Maximum number of events to return; must not exceed 1000.
>
> **query** `string`
>
> Datadog event search query.
>
> **cursor** `string`
>
> Cursor from meta.page.after in a previous response.
>
> **to\_time** `string`
>
> End time as date math or a millisecond timestamp string.
>
> **timezone** `string`
>
> Timezone used for date math; mutually exclusive with time\_offset.
>
> **from\_time** `string`
>
> Start time as date math or a millisecond timestamp string.
>
> **time\_offset** `integer`
>
> UTC offset in seconds; mutually exclusive with timezone.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search logs
>
> **Slug:** `DATADOG_SEARCH_LOGS`
>
> Searches 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
>
> **index** `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.
>
> **limit** `integer`
>
> Maximum number of logs to return (max 1000, default 50)
>
> **query** `string` *required*
>
> Log search query string
>
> **time\_to** `integer` *required*
>
> End time as UNIX timestamp (in milliseconds). Note: Time range cannot exceed 15 days.
>
> **start\_at** `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.
>
> **time\_from** `integer` *required*
>
> Start time as UNIX timestamp (in milliseconds). Note: Time range cannot exceed 15 days.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search logs (POST)
>
> **Slug:** `DATADOG_SEARCH_LOGS_V2`
>
> Search logs (POST). Uses POST /api/v2/logs/events/search. Supply the documented payload in body. Datadog permission(s): logs\_read\_data.
>
> #### Input Parameters
>
> **body** `object`
>
> The request for a logs list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search metrics
>
> **Slug:** `DATADOG_SEARCH_METRICS`
>
> Search 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
>
> **query** `string` *required*
>
> Metric-name search text; may include the metrics: prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search monitor groups
>
> **Slug:** `DATADOG_SEARCH_MONITOR_GROUPS`
>
> Searches triggered Datadog monitor groups using monitor-group query grammar.
>
> #### Input Parameters
>
> **page** `integer`
>
> Zero-based page to return.
>
> **sort** `string`
>
> Sort field and direction separated by a comma. Supported fields are name, status, and tags; directions are asc and desc.
>
> **query** `string`
>
> Monitor-group query using Datadog's triggered-monitor search grammar, such as 'type:metric group\_status:alert'.
>
> **per\_page** `integer`
>
> Number of monitor groups to return per page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search monitors
>
> **Slug:** `DATADOG_SEARCH_MONITORS`
>
> Search monitor configurations using Datadog's monitor query grammar.
>
> #### Input Parameters
>
> **page** `integer`
>
> Zero-based page to return.
>
> **sort** `string`
>
> Sort field and direction separated by a comma. Supported fields are name, status, and tags; directions are asc and desc.
>
> **query** `string`
>
> Monitor query using Datadog's manage-monitor search grammar, such as 'type:metric status:alert'.
>
> **per\_page** `integer`
>
> Number of monitors to return per page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search for SLOs
>
> **Slug:** `DATADOG_SEARCH_SLO`
>
> Search 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
>
> **query** `string`
>
> The query string to filter results based on SLO names. Some examples of queries include `service:<service-name>` and `<slo-name>`.
>
> **page\_size** `integer`
>
> The number of files to return in the response `[default=10]`.
>
> **page\_number** `integer`
>
> The identifier of the first page to return. This parameter is used for the pagination feature `[default=0]`.
>
> **include\_facets** `boolean`
>
> Whether or not to return facet information in the response `[default=false]`.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Spans Analytics
>
> **Slug:** `DATADOG_SEARCH_SPANS_ANALYTICS`
>
> Search and analyze Datadog trace span data using filters, grouping, and aggregations. Use it to investigate latency patterns, errors, and performance bottlenecks.
>
> #### Input Parameters
>
> **filter** `object` *required*
>
> Filter criteria for span search
>
> **compute** `array`
>
> Aggregations to compute
>
> **options** `object`
>
> Additional search options
>
> **group\_by** `array`
>
> Group by configuration for aggregations
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search test suites
>
> **Slug:** `DATADOG_SEARCH_SUITES`
>
> Search 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
>
> **sort** `string`
>
> The sort order for the results (e.g., `name,asc` or `name,desc`).
>
> **count** `integer`
>
> The maximum number of results to return.
>
> **query** `string`
>
> The search query.
>
> **start** `integer`
>
> The offset from which to start returning results.
>
> **facets\_only** `boolean`
>
> If true, return only facets instead of full test details.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Synthetic tests
>
> **Slug:** `DATADOG_SEARCH_TESTS`
>
> Search 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
>
> **sort** `string`
>
> The sort order for the results (e.g., `name,asc` or `name,desc`).
>
> **text** `string`
>
> The search query.
>
> **count** `integer`
>
> The maximum number of results to return.
>
> **start** `integer`
>
> The offset from which to start returning results.
>
> **facets\_only** `boolean`
>
> If true, return only facets instead of full test details.
>
> **include\_full\_config** `boolean`
>
> If true, include the full configuration for each test in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Traces
>
> **Slug:** `DATADOG_SEARCH_TRACES`
>
> Search 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
>
> **page** `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.
>
> **sort** `object`
>
> Sort configuration for trace search.
>
> **filter** `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.
>
> **options** `object`
>
> Additional search options
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send shared dashboard invitation email
>
> **Slug:** `DATADOG_SEND_PUBLIC_DASHBOARD_INVITATION`
>
> Send 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
>
> **body** `object` *required*
>
> Shared Dashboard Invitation request body.
>
> **token** `string` *required*
>
> The token of the shared dashboard.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save new value for on-demand concurrency cap
>
> **Slug:** `DATADOG_SET_ON_DEMAND_CONCURRENCY_CAP`
>
> Save 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
>
> **body** `object` *required*
>
> .
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set On-Call team routing rules
>
> **Slug:** `DATADOG_SET_TEAM_ROUTING_RULES`
>
> Replaces (sets) the On-Call routing rules for a Datadog team.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The team routing rules to set (JSON:API `data` object).
>
> **team\_id** `string` *required*
>
> Unique identifier of the Datadog On-Call team whose routing rules should be replaced.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit distribution points
>
> **Slug:** `DATADOG_SUBMIT_DISTRIBUTION_POINTS`
>
> Submit distribution points. Uses POST /api/v1/distribution\_points. Supply the documented payload in body.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> The documented request body.
>
> **Content-Encoding** `string`
>
> HTTP header used to compress the media-type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send logs
>
> **Slug:** `DATADOG_SUBMIT_LOG`
>
> Send logs. Uses POST /api/v2/logs. Supply the documented payload in body. Uses the documented regional intake endpoint.
>
> #### Input Parameters
>
> **body** `array` *required*
>
> Log to send (JSON format).
>
> **ddtags** `string`
>
> Log tags can be passed as query parameters with `text/plain` content type.
>
> **Content-Encoding** `string ("identity" | "gzip" | "deflate")`
>
> HTTP header used to compress the media-type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit metrics
>
> **Slug:** `DATADOG_SUBMIT_METRICS`
>
> Submits custom metrics to Datadog. Useful for sending application-specific metrics, business KPIs, or custom performance indicators.
>
> #### Input Parameters
>
> **series** `array` *required*
>
> List of metric series to submit
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit metrics
>
> **Slug:** `DATADOG_SUBMIT_METRICS_V2`
>
> Submit metrics. Uses POST /api/v2/series. Supply the documented payload in body.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> The documented request body.
>
> **Content-Encoding** `string ("deflate" | "zstd1" | "gzip")`
>
> HTTP header used to compress the media-type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit a Service Check
>
> **Slug:** `DATADOG_SUBMIT_SERVICE_CHECK`
>
> Submit one or more service checks using POST /api/v1/check\_run. Supply the service checks in the body.
>
> #### Input Parameters
>
> **body** `array` *required*
>
> Service Check request body.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Trigger tests from CI/CD pipelines
>
> **Slug:** `DATADOG_TRIGGER_CI_TESTS`
>
> Trigger 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
>
> **body** `object` *required*
>
> Details of the test to trigger.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Trigger Synthetic tests
>
> **Slug:** `DATADOG_TRIGGER_TESTS`
>
> Trigger Synthetic tests. Uses POST /api/v1/synthetics/tests/trigger. Supply the documented payload in body. Datadog permission(s): synthetics\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> The identifiers of the tests to trigger.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unmute Monitor
>
> **Slug:** `DATADOG_UNMUTE_MONITOR`
>
> Unmute 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
>
> **all\_scopes** `boolean`
>
> Whether to unmute the monitor for all scopes (default: false)
>
> **monitor\_id** `integer` *required*
>
> The ID of the monitor to unmute
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit an API test
>
> **Slug:** `DATADOG_UPDATE_API_TEST`
>
> Edit 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
>
> **body** `object` *required*
>
> New test details to be saved.
>
> **public\_id** `string` *required*
>
> The public ID of the test to get details from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit a browser test
>
> **Slug:** `DATADOG_UPDATE_BROWSER_TEST`
>
> Edit 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
>
> **body** `object` *required*
>
> New test details to be saved.
>
> **public\_id** `string` *required*
>
> The public ID of the test to edit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Dashboard
>
> **Slug:** `DATADOG_UPDATE_DASHBOARD`
>
> Update a dashboard in Datadog. Updates an existing dashboard with new configuration, widgets, or layout while preserving its identity and creation metadata.
>
> #### Input Parameters
>
> **tags** `array`
>
> Tags to associate with the dashboard
>
> **title** `string`
>
> Dashboard title
>
> **widgets** `array`
>
> List of widgets to include in the dashboard
>
> **description** `string`
>
> Dashboard description
>
> **layout\_type** `string`
>
> Dashboard layout type ('ordered' or 'free')
>
> **notify\_list** `array`
>
> List of users to notify of dashboard changes
>
> **reflow\_type** `string`
>
> Reflow type for ordered layout dashboards ('auto' or 'fixed'). Forwarded to Datadog only when set so existing values aren't clobbered.
>
> **dashboard\_id** `string` *required*
>
> Dashboard ID to update
>
> **is\_read\_only** `boolean`
>
> Whether the dashboard is read-only
>
> **pause\_auto\_refresh** `boolean`
>
> Whether automatic refresh is paused for this dashboard. Forwarded to Datadog only when set so existing values aren't clobbered.
>
> **template\_variables** `array`
>
> Template variables for dynamic dashboards
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a dashboard list
>
> **Slug:** `DATADOG_UPDATE_DASHBOARD_LIST`
>
> Update 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
>
> **body** `object` *required*
>
> Update a dashboard list request body.
>
> **list\_id** `integer` *required*
>
> ID of the dashboard list to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update items of a dashboard list
>
> **Slug:** `DATADOG_UPDATE_DASHBOARD_LIST_ITEMS`
>
> Replace the dashboards in a manual dashboard list with the supplied list using PUT /api/v2/dashboard/lists/manual/\{dashboard\_list\_id}/dashboards.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> New dashboards of the dashboard list.
>
> **dashboard\_list\_id** `integer` *required*
>
> ID of the dashboard list to update items from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a derived metric
>
> **Slug:** `DATADOG_UPDATE_DERIVED_METRIC`
>
> Update 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
>
> **body** `object` *required*
>
> The documented request body.
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a downtime
>
> **Slug:** `DATADOG_UPDATE_DOWNTIME`
>
> Update a downtime. Uses PATCH /api/v2/downtime/\{downtime\_id}. Supply the documented payload in body. Datadog permission(s): monitors\_downtime.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Update a downtime request body.
>
> **downtime\_id** `string` *required*
>
> ID of the downtime to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update On-Call escalation policy
>
> **Slug:** `DATADOG_UPDATE_ESCALATION_POLICY`
>
> Updates a Datadog On-Call escalation policy by ID.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The Datadog On-Call escalation policy update (JSON:API `data` object).
>
> **policy\_id** `string` *required*
>
> Unique identifier of the On-Call escalation policy to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update host tags
>
> **Slug:** `DATADOG_UPDATE_HOST_TAGS`
>
> Updates tags for a specific host in Datadog. This replaces all existing tags from the specified source with the new tags provided.
>
> #### Input Parameters
>
> **tags** `array` *required*
>
> List of tags to assign to the host (replaces existing tags)
>
> **source** `string`
>
> Source of the tags (e.g., 'users', 'chef', 'puppet'). Defaults to 'users'
>
> **host\_name** `string` *required*
>
> Name of the host to update tags for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit metric metadata
>
> **Slug:** `DATADOG_UPDATE_METRIC_METADATA`
>
> Edit metric metadata. Uses PUT /api/v1/metrics/\{metric\_name}. Supply the documented payload in body. Datadog permission(s): metrics\_metadata\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> New metadata.
>
> **metric\_name** `string` *required*
>
> Name of the metric for which to edit metadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit a mobile test
>
> **Slug:** `DATADOG_UPDATE_MOBILE_TEST`
>
> Edit 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
>
> **body** `object` *required*
>
> New test details to be saved.
>
> **public\_id** `string` *required*
>
> The public ID of the test to get details from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update monitor
>
> **Slug:** `DATADOG_UPDATE_MONITOR`
>
> Updates an existing Datadog monitor with new configuration, thresholds, or notification settings. Only specified fields will be updated.
>
> #### Input Parameters
>
> **name** `string`
>
> Name of the monitor
>
> **tags** `array`
>
> List of tags to assign to the monitor
>
> **type** `string ("metric alert" | "service check" | "event alert" | "query alert" | "composite" | "log alert")`
>
> Type of monitor.
>
> **query** `string`
>
> Query that defines what the monitor tracks
>
> **message** `string`
>
> Message to include in notifications (supports @mentions and markdown)
>
> **options** `object`
>
> Monitor update configuration options.
>
> **priority** `integer`
>
> Priority level (1-5, where 1 is highest)
>
> **monitor\_id** `integer` *required*
>
> The ID of the monitor to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit a monitor configuration policy
>
> **Slug:** `DATADOG_UPDATE_MONITOR_CONFIG_POLICY`
>
> Edit 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
>
> **body** `object` *required*
>
> Description of the update.
>
> **policy\_id** `string` *required*
>
> ID of the monitor configuration policy.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a monitor notification rule
>
> **Slug:** `DATADOG_UPDATE_MONITOR_NOTIFICATION_RULE`
>
> Update 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
>
> **body** `object` *required*
>
> Request body to update the monitor notification rule.
>
> **rule\_id** `string` *required*
>
> ID of the monitor notification rule to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a notebook
>
> **Slug:** `DATADOG_UPDATE_NOTEBOOK`
>
> Update 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
>
> **body** `object` *required*
>
> Update notebook request body.
>
> **notebook\_id** `integer` *required*
>
> Unique ID, assigned when you create the notebook.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update On-Call notification rule
>
> **Slug:** `DATADOG_UPDATE_NOTIFICATION_RULE`
>
> Updates an On-Call notification rule for a user by ID.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The On-Call notification rule update (JSON:API `data` object).
>
> **rule\_id** `string` *required*
>
> Unique identifier of the On-Call notification rule to update.
>
> **user\_id** `string` *required*
>
> Unique identifier of the user whose On-Call notification rule you want to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit a private location
>
> **Slug:** `DATADOG_UPDATE_PRIVATE_LOCATION`
>
> Edit 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
>
> **body** `object` *required*
>
> Details of the private location to be updated.
>
> **location\_id** `string` *required*
>
> The ID of the private location.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a shared dashboard
>
> **Slug:** `DATADOG_UPDATE_PUBLIC_DASHBOARD`
>
> Update 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
>
> **body** `object` *required*
>
> Update Dashboard request body.
>
> **token** `string` *required*
>
> The token of the shared dashboard.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update On-Call schedule
>
> **Slug:** `DATADOG_UPDATE_SCHEDULE`
>
> Updates a Datadog On-Call schedule by ID.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The Datadog On-Call schedule update (JSON:API `data` object).
>
> **schedule\_id** `string` *required*
>
> Unique identifier of the Datadog On-Call schedule to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an SLO
>
> **Slug:** `DATADOG_UPDATE_SLO`
>
> Update an SLO. Uses PUT /api/v1/slo/\{slo\_id}. Supply the documented payload in body. Datadog permission(s): slos\_write.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> The edited service level objective request object.
>
> **slo\_id** `string` *required*
>
> The ID of the service level objective object.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a Synthetics downtime
>
> **Slug:** `DATADOG_UPDATE_SYNTHETICS_DOWNTIME`
>
> Update 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
>
> **body** `object` *required*
>
> The documented request body.
>
> **downtime\_id** `string` *required*
>
> The ID of the downtime to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit a Network Path test
>
> **Slug:** `DATADOG_UPDATE_SYNTHETICS_NETWORK_TEST`
>
> Edit 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
>
> **body** `object` *required*
>
> New Network Path test details to be saved.
>
> **public\_id** `string` *required*
>
> The public ID of the Network Path test to edit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a tag configuration
>
> **Slug:** `DATADOG_UPDATE_TAG_CONFIGURATION`
>
> Update 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
>
> **body** `object` *required*
>
> The documented request body.
>
> **metric\_name** `string` *required*
>
> The name of the metric.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Pause or start a test
>
> **Slug:** `DATADOG_UPDATE_TEST_PAUSE_STATUS`
>
> Pause 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
>
> **body** `object` *required*
>
> Status to set the given Synthetic test to.
>
> **public\_id** `string` *required*
>
> The public ID of the Synthetic test to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create or update entities
>
> **Slug:** `DATADOG_UPSERT_CATALOG_ENTITY`
>
> Create or update entities. Uses POST /api/v2/catalog/entity. Supply the documented payload in body.
>
> #### Input Parameters
>
> **body** `string` *required*
>
> Entity YAML or JSON.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create or update kinds
>
> **Slug:** `DATADOG_UPSERT_CATALOG_KIND`
>
> Create or update kinds. Uses POST /api/v2/catalog/kind. Supply the documented payload in body.
>
> #### Input Parameters
>
> **body** `string` *required*
>
> Kind YAML or JSON.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate API and application keys
>
> **Slug:** `DATADOG_VALIDATE_API_KEY`
>
> Check 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate monitor
>
> **Slug:** `DATADOG_VALIDATE_MONITOR`
>
> Validate a Datadog monitor definition without creating or updating it.
>
> #### Input Parameters
>
> **name** `string`
>
> Monitor name.
>
> **tags** `array`
>
> Tags assigned to the monitor.
>
> **type** `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.
>
> **query** `string` *required*
>
> Datadog query whose syntax must match the monitor type.
>
> **assets** `array`
>
> Links that help users act on monitor alerts.
>
> **message** `string`
>
> Notification message, including any mentions or Markdown.
>
> **options** `object`
>
> Common options accepted by Datadog monitor creation and validation.
>
> **priority** `integer`
>
> Alert priority from 1 (highest) to 5 (lowest).
>
> **draft\_status** `string ("draft" | "published")`
>
> Whether the monitor is a non-notifying draft or is published.
>
> **restricted\_roles** `array`
>
> Role UUIDs permitted to edit the monitor.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate monitor update
>
> **Slug:** `DATADOG_VALIDATE_MONITOR_UPDATE`
>
> Validate a proposed configuration for an existing monitor without applying it.
>
> #### Input Parameters
>
> **name** `string`
>
> Proposed monitor name to validate.
>
> **tags** `array`
>
> Proposed monitor tags to validate.
>
> **type** `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.
>
> **query** `string` *required*
>
> Monitor query to validate. Its syntax must match the monitor type.
>
> **assets** `array`
>
> Monitor assets, such as runbook links, to validate.
>
> **message** `string`
>
> Proposed monitor notification message to validate.
>
> **options** `object`
>
> Proposed monitor options and thresholds to validate.
>
> **priority** `integer`
>
> Proposed monitor priority, or null to clear it.
>
> **monitor\_id** `integer` *required*
>
> ID of the existing monitor whose proposed configuration is validated.
>
> **draft\_status** `string ("draft" | "published")`
>
> Proposed monitor state: draft or published.
>
> **restricted\_roles** `array`
>
> Role IDs allowed to edit the monitor, or null to remove restrictions.
>
> **matching\_downtimes** `array`
>
> Active v1 downtimes associated with the monitor.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
