Your AI team, working in Datadog

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

Start your company

What your team can do in Datadog

255 tools to work with, connected with an API key.

Abort a multipart upload of a test file

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 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.

Add a test to a 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.

Add Items to a Dashboard List

Add Items to a Dashboard List. Uses POST /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards. Supply the documented payload in body.

Aggregate logsReads only

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.

Aggregate RUM eventsReads only

Aggregate Datadog RUM events into grouped metric or timeseries buckets. API/application keys require the ``rum_apps_read`` RBAC permission. Datadog does not expose that permission as an OAuth authorization scope.

Bulk Delete SLO Timeframes

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

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

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

Cancel a downtime. Uses DELETE /api/v2/downtime/{downtime_id}. Datadog permission(s): monitors_downtime.

Check if a monitor can be deletedReads only

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 deletedReads only

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

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

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

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

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

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

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

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

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

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

Create a notebook. Uses POST /api/v1/notebooks. Supply the documented payload in body. Datadog permission(s): notebooks_write.

Create a shared 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.

Create a 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.

Create a 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.

Create a test 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.

Create an API test

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

Create an incident impact. Uses POST /api/v2/incidents/{incident_id}/impacts. Supply the documented payload in body. Datadog permission(s): incident_write.

Create Dashboard

Create a dashboard in Datadog. Dashboards provide customizable visualizations for monitoring your infrastructure, applications, and business metrics in a unified view.

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.

Create event

Creates a new event in Datadog. Events are useful for tracking deployments, outages, configuration changes, and other important occurrences.

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.

Create monitor

Creates a new Datadog monitor to track metrics, logs, or other data sources with configurable alerting thresholds and notifications.

Create On-Call escalation policy

Creates a Datadog On-Call escalation policy.

Create On-Call notification channel

Creates an On-Call notification channel for a Datadog user.

Create On-Call notification rule

Creates an On-Call notification rule for a Datadog user.

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.

Create On-Call schedule

Creates a Datadog On-Call schedule.

Create On-Call 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.

Create or update entities

Create or update entities. Uses POST /api/v2/catalog/entity. Supply the documented payload in body.

Create or update kinds

Create or update kinds. Uses POST /api/v2/catalog/kind. Supply the documented payload in body.

Create or update service definition

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 SLO

Create a metric-based or monitor-based Service Level Objective (SLO) in Datadog to track service reliability targets.

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.

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.

Create workflow

Create a Datadog Workflow Automation workflow. Requires the ``workflows_write`` Datadog permission, which is not among this toolkit's default OAuth scopes. Creating with ``published: true`` lets the workflow's automatic triggers start running it immediately. GitHub webhook triggers are not supported here because they need a GitHub webhook secret; add them and their secret in the Datadog UI.

Delete a dashboard list

Delete a dashboard list. Uses DELETE /api/v1/dashboard/lists/manual/{list_id}. Datadog permission(s): dashboards_write.

Delete a derived metric

Delete a derived metric. Uses DELETE /api/v2/metrics/derived-metrics/{metric_name}. Datadog permission(s): metric_tags_write.

Delete a global variable

Delete a global variable. Uses DELETE /api/v1/synthetics/variables/{variable_id}. Datadog permission(s): synthetics_global_variable_write.

Delete a monitor configuration policy

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

Delete a monitor notification rule. Uses DELETE /api/v2/monitor/notification_rule/{rule_id}. Datadog permission(s): monitor_config_policy_write.

Delete a notebook

Delete a notebook. Uses DELETE /api/v1/notebooks/{notebook_id}. Datadog permission(s): notebooks_write.

Delete a private location

Delete a private location. Uses DELETE /api/v1/synthetics/private-locations/{location_id}. Datadog permission(s): synthetics_private_location_write.

Delete a single entity

Delete a single entity. Uses DELETE /api/v2/catalog/entity/{entity_id}.

Delete a single kind

Delete a single kind. Uses DELETE /api/v2/catalog/kind/{kind_id}.

Delete a single service definition

Delete a single service definition. Uses DELETE /api/v2/services/definitions/{service_name}. Datadog permission(s): apm_service_catalog_write.

Delete a Synthetics downtime

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

Delete a tag configuration. Uses DELETE /api/v2/metrics/{metric_name}/tags. Datadog permission(s): metric_tags_write.

Delete an incident impact

Delete an incident impact. Uses DELETE /api/v2/incidents/{incident_id}/impacts/{impact_id}. Datadog permission(s): incident_write.

Delete an SLO

Delete an SLO. Uses DELETE /api/v1/slo/{slo_id}. Datadog permission(s): slos_write.

Delete Dashboard

Delete a dashboard in Datadog. Permanently removes a dashboard from your organization. This action cannot be undone. Use with caution.

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.

Delete items from a dashboard list

Delete items from a dashboard list. Uses DELETE /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards. Supply the documented payload in body.

Delete monitor

Deletes a Datadog monitor permanently. Use with caution as this action cannot be undone.

Delete On-Call escalation policy

Deletes a Datadog On-Call escalation policy by ID. This action cannot be undone.

Delete On-Call notification channel

Deletes an On-Call notification channel for a Datadog user. This action cannot be undone.

Delete On-Call notification rule

Deletes an On-Call notification rule for a Datadog user. This action cannot be undone.

Delete On-Call schedule

Deletes a Datadog On-Call schedule by ID. This action cannot be undone.

Delete On-Call 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.

Delete tests

Delete tests. Uses POST /api/v1/synthetics/tests/delete. Supply the documented payload in body. Datadog permission(s): synthetics_write.

Delete workflow

Permanently delete a Datadog Workflow Automation workflow by ID. Requires the ``workflows_write`` Datadog permission, which is not among this toolkit's default OAuth scopes.

Edit a 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.

Edit a 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.

Edit a 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.

Edit a monitor configuration 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.

Edit a Network Path 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.

Edit a 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.

Edit a test suite

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

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

Edit metric metadata. Uses PUT /api/v1/metrics/{metric_name}. Supply the documented payload in body. Datadog permission(s): metrics_metadata_write.

Escalate On-Call Page

Escalate a Datadog On-Call page identified by its page ID. The result indicates whether Datadog accepted the escalation request.

Fetch uptime for multiple testsReads only

Fetch uptime for multiple tests. Uses POST /api/v1/synthetics/tests/uptimes. Supply the documented payload in body. Datadog permission(s): synthetics_read.

Get a browser testReads only

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 browser test resultReads only

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 browser test resultReads only

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 resultsReads only

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 a browser test's latest results summariesReads only

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.

Get a dashboard listReads only

Fetch an existing dashboard list definition by ID. Uses GET /api/v1/dashboard/lists/manual/{list_id}. Datadog permission(s): dashboards_read.

Get a derived metricReads only

Get the definition of a derived metric by name. Uses GET /api/v2/metrics/derived-metrics/{metric_name}. Datadog permission(s): metrics_read.

Get a downtimeReads only

Get downtime detail by downtime_id. Uses GET /api/v2/downtime/{downtime_id}. Datadog permission(s): monitors_downtime.

Get a fast test resultReads only

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 global variableReads only

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 entitiesReads only

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 kindsReads only

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 relationsReads only

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 eventsReads only

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 metricsReads only

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 a mobile testReads only

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 policyReads only

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 ruleReads only

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 testReads only

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 notebookReads only

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 fileReads only

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 private locationReads only

Get a Synthetic private location by its ID. Uses GET /api/v1/synthetics/private-locations/{location_id}. Datadog permission(s): synthetics_private_location_read.

Get a shared dashboardReads only

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 definitionReads only

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 testReads only

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 suiteReads only

Get a Synthetics suite by its public ID. Uses GET /api/v2/synthetics/suites/{public_id}. Datadog permission(s): synthetics_read.

Get a Synthetics downtimeReads only

Get a Synthetics downtime by its ID. Uses GET /api/v2/synthetics/downtimes/{downtime_id}. Datadog permission(s): synthetics_read.

Get a test configurationReads only

Get the detailed configuration associated with a Synthetic test. Uses GET /api/v1/synthetics/tests/{public_id}. Datadog permission(s): synthetics_read.

Get a test resultReads only

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 a test's latest resultsReads only

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 a webhook integrationReads only

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 monitorReads only

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.

Get all dashboard listsReads only

Fetch all existing dashboard list definitions. Uses GET /api/v1/dashboard/lists/manual without pagination parameters. Required Datadog permission: dashboards_read.

Get all downtimesReads only

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 global variablesReads only

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 dashboardReads only

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 policiesReads only

Get all monitor configuration policies. Uses GET /api/v2/monitor/policy. Datadog permission(s): monitors_read.

Get all monitor notification rulesReads only

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 notebooksReads only

Get all notebooks. Uses GET /api/v1/notebooks. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): notebooks_read.

Get an API testReads only

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 resultReads only

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 summariesReads only

Get an API test's latest results summaries. Uses GET /api/v1/synthetics/tests/{public_id}/results. Datadog permission(s): synthetics_read.

Get an eventReads only

Get event details by event ID using GET /api/v1/events/{event_id}. Datadog permission(s): events_read.

Get an eventReads only

Get the details of an event by event_id. Uses GET /api/v2/events/{event_id}. Datadog permission(s): events_read.

Get an SLO's detailsReads only

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 historyReads only

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 available subtests for a multistep testReads only

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 For an SLOReads only

Get corrections applied to an SLO. Uses GET /api/v1/slo/{slo_id}/corrections. Datadog permission(s): slos_read.

Get Custom Evaluator ConfigurationReads only

Retrieve one custom Agent Observability evaluator configuration by name. Datadog currently exposes this read operation as a preview API.

Get DashboardReads only

Get a specific dashboard from Datadog. Retrieves detailed information about a dashboard including its widgets, layout, template variables, and metadata.

Get details of batchReads only

Get updated details of a batch. Uses GET /api/v1/synthetics/ci/batch/{batch_id}. Datadog permission(s): synthetics_read.

Get host tagsReads only

Retrieves tags associated with a specific host in Datadog, optionally filtered by tag source. Useful for understanding host metadata and organizing infrastructure.

Get hourly usageReads only

Gets hourly Datadog usage records for product families and a UTC hour range.

Get items of a Dashboard ListReads only

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 metric metadataReads only

Get metadata for a specific metric using GET /api/v1/metrics/{metric_name}. Datadog permission(s): metrics_read.

Get monitorReads only

Retrieves detailed information about a specific Datadog monitor, including its current state, configuration, and any active downtimes.

Get On-Call escalation policyReads only

Retrieves a Datadog On-Call escalation policy by ID.

Get On-Call notification channelReads only

Retrieves an On-Call notification channel for a user by ID.

Get On-Call notification ruleReads only

Retrieves an On-Call notification rule for a user by ID.

Get on-call responders for a scheduleReads only

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.

Get On-Call scheduleReads only

Retrieves a Datadog On-Call schedule by ID.

Get On-Call team routing rulesReads only

Gets the Datadog On-Call routing rules configured for a team.

Get parent suites for a testReads only

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 parent tests for a subtestReads only

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.

Get presigned URLs for uploading a test file

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.

Get scheduled on-call userReads only

Gets the currently scheduled on-call user for a Datadog On-Call schedule using a deprecated Datadog endpoint.

Get Service DependenciesReads only

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.

Get Synthetics LocationsReads only

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 detailsReads only

Get tag key cardinality details for a specific metric. Uses GET /api/v2/metrics/{metric_name}/tag-cardinalities. Datadog permission(s): metrics_read.

Get team on-call usersReads only

Gets the current on-call users for a Datadog On-Call team.

Get the default locationsReads only

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 capReads only

Get the on-demand concurrency cap. Uses GET /api/v2/synthetics/settings/on_demand_concurrency_cap. Datadog permission(s): billing_read.

Get usage summaryReads only

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.

Get userReads only

Retrieve one Datadog organization user by ID, including related resources.

Get version history of a testReads only

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.

Get workflow instanceReads only

Retrieve one Datadog workflow execution and its current state. Requires the ``workflows_read`` Datadog permission, which is not among this toolkit's default OAuth scopes.

List active metricsReads only

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 active tags and aggregationsReads only

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 integrationsReads only

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 All TagsReads only

List Datadog host tags, optionally filtered by source. Tags help organize and filter infrastructure.

List an incident's impactsReads only

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 API KeysReads only

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 APM ServicesReads only

List Datadog APM services, optionally filtering by environment. Use '*' to include services across environments.

List AWS IntegrationReads only

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.

List dashboardsReads only

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.

List distinct metric volumes by metric nameReads only

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.

List eventsReads only

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.

List hostsReads only

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 IncidentsReads only

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.

List Log IndexesReads only

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 metric tagsReads only

List indexed and ingested tags observed for one Datadog metric.

List monitorsReads only

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.

List On-Call notification channelsReads only

Lists the On-Call notification channels configured for a Datadog user.

List On-Call notification rulesReads only

Lists the On-Call notification rules configured for a Datadog user.

List On-Call schedule overridesReads only

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 schedulesReads only

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 OrganizationsReads only

List top-level Datadog organization metadata visible to the account.

List RolesReads only

List roles from Datadog organization. Roles define sets of permissions that control what users can do within your Datadog organization.

List service checksReads only

Lists service checks from Datadog. Service checks are status checks that track the health of your services and infrastructure components.

List service definitionsReads only

Page through service definitions in the Datadog Service Catalog.

List SLOsReads only

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 span-based metricsReads only

List configured Datadog span-based metrics and their definitions.

List Synthetics downtimesReads only

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 TestsReads only

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.

List tag configuration by nameReads only

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 UsersReads only

List users from Datadog organization. User management allows you to see team members, their roles, and access levels within your Datadog organization.

List WebhooksReads only

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 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.

Patch a 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.

Patch a Synthetic test

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

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

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 resultsReads only

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

Post an event. Uses POST /api/v2/events. Supply the documented payload in body. Uses the documented regional intake endpoint.

Preview catalog entitiesReads only

Preview catalog entities. Uses POST /api/v2/catalog/entity/preview.

Query metricsReads only

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.

Query scalar dataReads only

Run Datadog formula queries and return aggregated scalar columns.

Query timeseries dataReads only

Runs Datadog multi-product formula queries and returns aligned timeseries values.

Related Assets to a MetricReads only

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

Remove a test from a Synthetics downtime. Uses DELETE /api/v2/synthetics/downtimes/{downtime_id}/tests/{test_id}. Datadog permission(s): synthetics_write.

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.

Restore deleted dashboards

Restore deleted dashboards. Uses PATCH /api/v1/dashboard. Supply the documented payload in body. Datadog permission(s): dashboards_write.

Revoke a shared dashboard URL

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

Revoke shared dashboard invitations. Uses DELETE /api/v1/dashboard/public/{token}/invitation. Supply the documented payload in body. Datadog permission(s): dashboards_invite_share.

Run workflow

Start a Datadog workflow with optional input values. Running a workflow executes its steps, which may modify resources or send notifications in Datadog and connected integrations. Requires the ``workflows_run`` Datadog permission, which is not among this toolkit's default OAuth scopes.

Save new value for 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.

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.

Search Agent Observability spansReads only

Search Agent Observability spans with structured filters and pagination.

Search audit logsReads only

Search Datadog Audit Trail events with filters and cursor pagination.

Search eventsReads only

Searches Datadog Event Management events with filters and pagination.

Search for SLOsReads only

Search for SLOs. Uses GET /api/v1/slo/search. Returns one page; pass the documented pagination fields to continue. Datadog permission(s): slos_read.

Search logsReads only

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)Reads only

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)Reads only

Search logs (POST). Uses POST /api/v2/logs/events/search. Supply the documented payload in body. Datadog permission(s): logs_read_data.

Search metricsReads only

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.

Search monitor groupsReads only

Searches triggered Datadog monitor groups using monitor-group query grammar.

Search monitorsReads only

Search monitor configurations using Datadog's monitor query grammar.

Search RUM eventsReads only

Search indexed RUM events with filtering, sorting, and cursor pagination. API/application keys require the ``rum_apps_read`` RBAC permission. Datadog does not expose that permission as an OAuth authorization scope.

Search spansReads only

Search spans. Uses POST /api/v2/spans/events/search. Supply the documented payload in body.

Search Spans AnalyticsReads only

Search and analyze Datadog trace span data using filters, grouping, and aggregations. Use it to investigate latency patterns, errors, and performance bottlenecks.

Search Synthetic testsReads only

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 suitesReads only

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 TracesReads only

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

Send logs. Uses POST /api/v2/logs. Supply the documented payload in body. Uses the documented regional intake endpoint.

Send shared dashboard invitation email

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.

Set On-Call team routing rules

Replaces (sets) the On-Call routing rules for a Datadog team.

Submit a Service Check

Submit one or more service checks using POST /api/v1/check_run. Supply the service checks in the body.

Submit distribution points

Submit distribution points. Uses POST /api/v1/distribution_points. Supply the documented payload in body.

Submit metrics

Submits custom metrics to Datadog. Useful for sending application-specific metrics, business KPIs, or custom performance indicators.

Submit metrics

Submit metrics. Uses POST /api/v2/series. Supply the documented payload in body.

Tag Configuration Cardinality EstimatorReads only

Tag Configuration Cardinality Estimator. Uses GET /api/v2/metrics/{metric_name}/estimate. Datadog permission(s): .

Trigger Synthetic tests

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

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 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.

Update a 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.

Update a 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.

Update a downtime

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

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

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

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

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

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

Update an SLO. Uses PUT /api/v1/slo/{slo_id}. Supply the documented payload in body. Datadog permission(s): slos_write.

Update Dashboard

Update a dashboard in Datadog. Updates an existing dashboard with new configuration, widgets, or layout while preserving its identity and creation metadata.

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.

Update items of a dashboard list

Replace the dashboards in a manual dashboard list with the supplied list using PUT /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards.

Update monitor

Updates an existing Datadog monitor with new configuration, thresholds, or notification settings. Only specified fields will be updated.

Update On-Call escalation policy

Updates a Datadog On-Call escalation policy by ID.

Update On-Call notification rule

Updates an On-Call notification rule for a user by ID.

Update On-Call schedule

Updates a Datadog On-Call schedule by ID.

Validate API and application keysReads only

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 monitorReads only

Validate a Datadog monitor definition without creating or updating it.

Validate monitor updateReads only

Validate a proposed configuration for an existing monitor without applying it.

More in Server monitoring

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or