Datadog offers monitoring, observability, and security for cloud-scale applications, unifying metrics, logs, and traces to help teams detect issues and optimize performance
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.
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.
Add a test to a Synthetics downtime. Uses PUT /api/v2/synthetics/downtimes/{downtime_id}/tests/{test_id}. Datadog permission(s): synthetics_write.
Add Items to a Dashboard List. Uses POST /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards. Supply the documented payload in body.
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.
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.
Bulk delete suites. Uses POST /api/v2/synthetics/suites/bulk-delete. Supply the documented payload in body. Datadog permission(s): synthetics_write.
Bulk delete tests. Uses POST /api/v2/synthetics/tests/bulk-delete. Supply the documented payload in body. Datadog permission(s): synthetics_write.
Cancel a downtime. Uses DELETE /api/v2/downtime/{downtime_id}. Datadog permission(s): monitors_downtime.
Check if the given monitors can be deleted. Uses GET /api/v1/monitor/can_delete. Datadog permission(s): monitors_read.
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.
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.
Create a browser test. Uses POST /api/v1/synthetics/tests/browser. Supply the documented payload in body. Datadog permission(s): synthetics_write.
Create a dashboard list. Uses POST /api/v1/dashboard/lists/manual. Supply the documented payload in body. Datadog permission(s): dashboards_write.
Create a derived metric. Uses POST /api/v2/metrics/derived-metrics. Supply the documented payload in body. Datadog permission(s): metric_tags_write.
Create a global variable. Uses POST /api/v1/synthetics/variables. Supply the documented payload in body. Datadog permission(s): synthetics_global_variable_write.
Create a mobile test. Uses POST /api/v1/synthetics/tests/mobile. Supply the documented payload in body. Datadog permission(s): synthetics_write.
Create a monitor configuration policy. Uses POST /api/v2/monitor/policy. Supply the documented payload in body. Datadog permission(s): monitor_config_policy_write.
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.
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.
Create a notebook. Uses POST /api/v1/notebooks. Supply the documented payload in body. Datadog permission(s): notebooks_write.
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.
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.
Create a tag configuration. Uses POST /api/v2/metrics/{metric_name}/tags. Supply the documented payload in body. Datadog permission(s): metric_tags_write.
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.
Create an API test. Uses POST /api/v1/synthetics/tests/api. Supply the documented payload in body. Datadog permission(s): synthetics_write.
Create an incident impact. Uses POST /api/v2/incidents/{incident_id}/impacts. Supply the documented payload in body. Datadog permission(s): incident_write.
Create a dashboard in Datadog. Dashboards provide customizable visualizations for monitoring your infrastructure, applications, and business metrics in a unified view.
Creates a new downtime in Datadog to suppress alerts during maintenance windows or planned outages. Useful for preventing false alarms during deployments or maintenance.
Creates a new event in Datadog. Events are useful for tracking deployments, outages, configuration changes, and other important occurrences.
Create a hosted PNG snapshot from a metric query or graph definition. The returned snapshot URL may take time to become available.
Creates a new Datadog monitor to track metrics, logs, or other data sources with configurable alerting thresholds and notifications.
Creates a Datadog On-Call escalation policy.
Creates an On-Call notification channel for a Datadog user.
Creates an On-Call notification rule for a Datadog user.
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.
Creates a Datadog On-Call schedule.
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.
Create or update entities. Uses POST /api/v2/catalog/entity. Supply the documented payload in body.
Create or update kinds. Uses POST /api/v2/catalog/kind. Supply the documented payload in body.
Create or update service definition. Uses POST /api/v2/services/definitions. Supply the documented payload in body. Datadog permission(s): apm_service_catalog_write.
Create a metric-based or monitor-based Service Level Objective (SLO) in Datadog to track service reliability targets.
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.
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.
Delete a dashboard list. Uses DELETE /api/v1/dashboard/lists/manual/{list_id}. Datadog permission(s): dashboards_write.
Delete a derived metric. Uses DELETE /api/v2/metrics/derived-metrics/{metric_name}. Datadog permission(s): metric_tags_write.
Delete a global variable. Uses DELETE /api/v1/synthetics/variables/{variable_id}. Datadog permission(s): synthetics_global_variable_write.
Delete a monitor configuration policy. Uses DELETE /api/v2/monitor/policy/{policy_id}. Datadog permission(s): monitor_config_policy_write.
Delete a monitor notification rule. Uses DELETE /api/v2/monitor/notification_rule/{rule_id}. Datadog permission(s): monitor_config_policy_write.
Delete a notebook. Uses DELETE /api/v1/notebooks/{notebook_id}. Datadog permission(s): notebooks_write.
Delete a private location. Uses DELETE /api/v1/synthetics/private-locations/{location_id}. Datadog permission(s): synthetics_private_location_write.
Delete a single entity. Uses DELETE /api/v2/catalog/entity/{entity_id}.
Delete a single kind. Uses DELETE /api/v2/catalog/kind/{kind_id}.
Delete a single service definition. Uses DELETE /api/v2/services/definitions/{service_name}. Datadog permission(s): apm_service_catalog_write.
Delete a Synthetics downtime. Uses DELETE /api/v2/synthetics/downtimes/{downtime_id}. Datadog permission(s): synthetics_write, synthetics_default_settings_write.
Delete a tag configuration. Uses DELETE /api/v2/metrics/{metric_name}/tags. Datadog permission(s): metric_tags_write.
Delete an incident impact. Uses DELETE /api/v2/incidents/{incident_id}/impacts/{impact_id}. Datadog permission(s): incident_write.
Delete an SLO. Uses DELETE /api/v1/slo/{slo_id}. Datadog permission(s): slos_write.
Delete a dashboard in Datadog. Permanently removes a dashboard from your organization. This action cannot be undone. Use with caution.
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.
Delete items from a dashboard list. Uses DELETE /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards. Supply the documented payload in body.
Deletes a Datadog monitor permanently. Use with caution as this action cannot be undone.
Deletes a Datadog On-Call escalation policy by ID. This action cannot be undone.
Deletes an On-Call notification channel for a Datadog user. This action cannot be undone.
Deletes an On-Call notification rule for a Datadog user. This action cannot be undone.
Deletes a Datadog On-Call schedule by ID. This action cannot be undone.
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.
Delete tests. Uses POST /api/v1/synthetics/tests/delete. Supply the documented payload in body. Datadog permission(s): synthetics_write.
Edit a browser test. Uses PUT /api/v1/synthetics/tests/browser/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.
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.
Edit a mobile test. Uses PUT /api/v1/synthetics/tests/mobile/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.
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.
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.
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.
Edit a test suite. Uses PUT /api/v2/synthetics/suites/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.
Edit an API test. Uses PUT /api/v1/synthetics/tests/api/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.
Edit metric metadata. Uses PUT /api/v1/metrics/{metric_name}. Supply the documented payload in body. Datadog permission(s): metrics_metadata_write.
Escalate a Datadog On-Call page identified by its page ID. The result indicates whether Datadog accepted the escalation request.
Fetch uptime for multiple tests. Uses POST /api/v1/synthetics/tests/uptimes. Supply the documented payload in body. Datadog permission(s): synthetics_read.
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.
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.
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.
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.
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.
Fetch an existing dashboard list definition by ID. Uses GET /api/v1/dashboard/lists/manual/{list_id}. Datadog permission(s): dashboards_read.
Get the definition of a derived metric by name. Uses GET /api/v2/metrics/derived-metrics/{metric_name}. Datadog permission(s): metrics_read.
Get downtime detail by downtime_id. Uses GET /api/v2/downtime/{downtime_id}. Datadog permission(s): monitors_downtime.
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.
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.
Get a list of entities. Uses GET /api/v2/catalog/entity. Returns one page; pass the documented pagination fields to continue.
Get a list of entity kinds. Uses GET /api/v2/catalog/kind. Returns one page; pass the documented pagination fields to continue.
Get a list of entity relations. Uses GET /api/v2/catalog/relation. Returns one page; pass the documented pagination fields to continue.
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.
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.
Get the detailed configuration of a Synthetic mobile test. Uses GET /api/v1/synthetics/tests/mobile/{public_id}. Datadog permission(s): synthetics_read.
Get a monitor configuration policy by policy_id. Uses GET /api/v2/monitor/policy/{policy_id}. Datadog permission(s): monitors_read.
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.
Get a Network Path test by its public ID. Uses GET /api/v2/synthetics/tests/network/{public_id}. Datadog permission(s): synthetics_read.
Get a notebook using its notebook ID. Uses GET /api/v1/notebooks/{notebook_id}. Datadog permission(s): notebooks_read.
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.
Get a Synthetic private location by its ID. Uses GET /api/v1/synthetics/private-locations/{location_id}. Datadog permission(s): synthetics_private_location_read.
Fetch sharing metadata for an existing shared dashboard by its sharing token. Uses GET /api/v1/dashboard/public/{token}. Datadog permission(s): dashboards_read.
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.
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.
Get a Synthetics suite by its public ID. Uses GET /api/v2/synthetics/suites/{public_id}. Datadog permission(s): synthetics_read.
Get a Synthetics downtime by its ID. Uses GET /api/v2/synthetics/downtimes/{downtime_id}. Datadog permission(s): synthetics_read.
Get the detailed configuration associated with a Synthetic test. Uses GET /api/v1/synthetics/tests/{public_id}. Datadog permission(s): synthetics_read.
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.
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.
Get the content of a webhook integration by name. Uses GET /api/v1/integration/webhooks/configuration/webhooks/{webhook_name}. Datadog permission(s): integrations_read.
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.
Fetch all existing dashboard list definitions. Uses GET /api/v1/dashboard/lists/manual without pagination parameters. Required Datadog permission: dashboards_read.
Get all downtimes. Uses GET /api/v2/downtime. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): monitors_downtime.
Get all Synthetic global variables. Uses GET /api/v1/synthetics/variables. Requires either synthetics_global_variable_read or apm_api_catalog_read permission.
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.
Get all monitor configuration policies. Uses GET /api/v2/monitor/policy. Datadog permission(s): monitors_read.
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.
Get all notebooks. Uses GET /api/v1/notebooks. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): notebooks_read.
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.
Get an API test result. Uses GET /api/v1/synthetics/tests/{public_id}/results/{result_id}. Datadog permission(s): synthetics_read.
Get an API test's latest results summaries. Uses GET /api/v1/synthetics/tests/{public_id}/results. Datadog permission(s): synthetics_read.
Get event details by event ID using GET /api/v1/events/{event_id}. Datadog permission(s): events_read.
Get the details of an event by event_id. Uses GET /api/v2/events/{event_id}. Datadog permission(s): events_read.
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.
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.
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.
Get corrections applied to an SLO. Uses GET /api/v1/slo/{slo_id}/corrections. Datadog permission(s): slos_read.
Retrieve one custom Agent Observability evaluator configuration by name. Datadog currently exposes this read operation as a preview API.
Get a specific dashboard from Datadog. Retrieves detailed information about a dashboard including its widgets, layout, template variables, and metadata.
Get updated details of a batch. Uses GET /api/v1/synthetics/ci/batch/{batch_id}. Datadog permission(s): synthetics_read.
Retrieves tags associated with a specific host in Datadog, optionally filtered by tag source. Useful for understanding host metadata and organizing infrastructure.
Gets hourly Datadog usage records for product families and a UTC hour range.
Fetch the dashboard definitions in a dashboard list. Uses GET /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards. Datadog permission(s): dashboards_read.
Get metadata for a specific metric using GET /api/v1/metrics/{metric_name}. Datadog permission(s): metrics_read.
Retrieves detailed information about a specific Datadog monitor, including its current state, configuration, and any active downtimes.
Retrieves a Datadog On-Call escalation policy by ID.
Retrieves an On-Call notification channel for a user by ID.
Retrieves an On-Call notification rule for a user by ID.
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.
Retrieves a Datadog On-Call schedule by ID.
Gets the Datadog On-Call routing rules configured for a team.
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.
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.
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.
Gets the currently scheduled on-call user for a Datadog On-Call schedule using a deprecated Datadog endpoint.
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.
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.
Get tag key cardinality details for a specific metric. Uses GET /api/v2/metrics/{metric_name}/tag-cardinalities. Datadog permission(s): metrics_read.
Gets the current on-call users for a Datadog On-Call team.
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.
Get the on-demand concurrency cap. Uses GET /api/v2/synthetics/settings/on_demand_concurrency_cap. Datadog permission(s): billing_read.
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.
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.
Retrieve one Datadog organization user by ID, including related resources.
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.
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.
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.
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.
List Datadog host tags, optionally filtered by source. Tags help organize and filter infrastructure.
List all impacts for an incident. Uses GET /api/v2/incidents/{incident_id}/impacts. Optionally include related incident resources. Datadog permission(s): incident_read.
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.
List Datadog APM services, optionally filtering by environment. Use '*' to include services across environments.
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.
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.
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.
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.
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.
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.
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.
List indexed and ingested tags observed for one Datadog metric.
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.
Lists the On-Call notification channels configured for a Datadog user.
Lists the On-Call notification rules configured for a Datadog user.
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.
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.
List top-level Datadog organization metadata visible to the account.
List roles from Datadog organization. Roles define sets of permissions that control what users can do within your Datadog organization.
Lists service checks from Datadog. Service checks are status checks that track the health of your services and infrastructure components.
Page through service definitions in the Datadog Service Catalog.
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.
List configured Datadog span-based metrics and their definitions.
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.
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.
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.
List users from Datadog organization. User management allows you to see team members, their roles, and access levels within your Datadog organization.
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.
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.
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.
Patch a Synthetic test. Uses PATCH /api/v1/synthetics/tests/{public_id}. Supply the documented payload in body. Datadog permission(s): synthetics_write.
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.
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.
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.
Post an event. Uses POST /api/v2/events. Supply the documented payload in body. Uses the documented regional intake endpoint.
Preview catalog entities. Uses POST /api/v2/catalog/entity/preview.
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.
Run Datadog formula queries and return aggregated scalar columns.
Runs Datadog multi-product formula queries and returns aligned timeseries values.
Returns dashboards, monitors, notebooks, and SLOs containing a metric. Updated every 24 hours. Uses GET /api/v2/metrics/{metric_name}/assets.
Remove a test from a Synthetics downtime. Uses DELETE /api/v2/synthetics/downtimes/{downtime_id}/tests/{test_id}. Datadog permission(s): synthetics_write.
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.
Restore deleted dashboards. Uses PATCH /api/v1/dashboard. Supply the documented payload in body. Datadog permission(s): dashboards_write.
Revoke a shared dashboard URL. Uses DELETE /api/v1/dashboard/public/{token}. Datadog permission(s): dashboards_public_share, dashboards_embed_share, dashboards_invite_share.
Revoke shared dashboard invitations. Uses DELETE /api/v1/dashboard/public/{token}/invitation. Supply the documented payload in body. Datadog permission(s): dashboards_invite_share.
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.
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.
Search Datadog Audit Trail events with filters and cursor pagination.
Searches Datadog Event Management events with filters and pagination.
Search for SLOs. Uses GET /api/v1/slo/search. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): slos_read.
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.
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.
Search logs (POST). Uses POST /api/v2/logs/events/search. Supply the documented payload in body. Datadog permission(s): logs_read_data.
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.
Searches triggered Datadog monitor groups using monitor-group query grammar.
Search monitor configurations using Datadog's monitor query grammar.
Search spans. Uses POST /api/v2/spans/events/search. Supply the documented payload in body.
Search and analyze Datadog trace span data using filters, grouping, and aggregations. Use it to investigate latency patterns, errors, and performance bottlenecks.
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.
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.
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.
Send logs. Uses POST /api/v2/logs. Supply the documented payload in body. Uses the documented regional intake endpoint.
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.
Replaces (sets) the On-Call routing rules for a Datadog team.
Submit one or more service checks using POST /api/v1/check_run. Supply the service checks in the body.
Submit distribution points. Uses POST /api/v1/distribution_points. Supply the documented payload in body.
Submits custom metrics to Datadog. Useful for sending application-specific metrics, business KPIs, or custom performance indicators.
Submit metrics. Uses POST /api/v2/series. Supply the documented payload in body.
Tag Configuration Cardinality Estimator. Uses GET /api/v2/metrics/{metric_name}/estimate. Datadog permission(s): .
Trigger Synthetic tests. Uses POST /api/v1/synthetics/tests/trigger. Supply the documented payload in body. Datadog permission(s): synthetics_write.
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.
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.
Update a dashboard list. Uses PUT /api/v1/dashboard/lists/manual/{list_id}. Supply the documented payload in body. Datadog permission(s): dashboards_write.
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.
Update a downtime. Uses PATCH /api/v2/downtime/{downtime_id}. Supply the documented payload in body. Datadog permission(s): monitors_downtime.
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.
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.
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.
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.
Update a tag configuration. Uses PATCH /api/v2/metrics/{metric_name}/tags. Supply the documented payload in body. Datadog permission(s): metric_tags_write.
Update an SLO. Uses PUT /api/v1/slo/{slo_id}. Supply the documented payload in body. Datadog permission(s): slos_write.
Update a dashboard in Datadog. Updates an existing dashboard with new configuration, widgets, or layout while preserving its identity and creation metadata.
Updates tags for a specific host in Datadog. This replaces all existing tags from the specified source with the new tags provided.
Replace the dashboards in a manual dashboard list with the supplied list using PUT /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards.
Updates an existing Datadog monitor with new configuration, thresholds, or notification settings. Only specified fields will be updated.
Updates a Datadog On-Call escalation policy by ID.
Updates an On-Call notification rule for a user by ID.
Updates a Datadog On-Call schedule by ID.
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.
Validate a Datadog monitor definition without creating or updating it.
Validate a proposed configuration for an existing monitor without applying it.
The Datadog integration connects your Dench AI CRM directly to Datadog, so agents can read and act on your Datadog data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
249 actions are available for agents to invoke on your behalf. Every call runs through Datadog's own authorization, scoped to the account you connect.
Sign in to your Dench workspace and open Integrations.
Find Datadog and click Connect — you'll authorize access through Datadog's own sign-in flow. No API keys or code required.
Ask an agent to use Datadog in chat, or call it from an automation.
Manage or disconnect the connection any time from workspace settings.
The Dench Datadog integration connects your AI CRM to Datadog, so AI agents can work with your Datadog data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
The Datadog integration currently exposes 249 actions, including Abort a multipart upload of a test file, Acknowledge On-Call Page, Add a test to a Synthetics downtime, Add Items to a Dashboard List, Aggregate logs, and Bulk Delete SLO Timeframes. Agents invoke them on your behalf from chat or from automations.
No. You connect Datadog from your Dench workspace using Datadog's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Connections are authorized through Datadog's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Datadog connection from your workspace settings at any time.