Datadog

Datadog API V1 Collection

Collection of all Datadog Public endpoints.

Developer tools#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Collection of all Datadog Public endpoints.

Endpoints 235

AWS Integration

  • GETList all AWS integrations/api/v1/integration/aws?account_id=string&role_name=string&access_key_id=stringDeprecated. This endpoint is deprecated - use the V2 endpoints instead. List all Datadog-AWS integrations available in your Datadog organization.
  • PUTUpdate an AWS integration/api/v1/integration/aws?account_id=string&role_name=string&access_key_id=stringDeprecated. This endpoint is deprecated - use the V2 endpoints instead. Update a Datadog-Amazon Web Services integration.
  • POSTCreate an AWS integration/api/v1/integration/awsDeprecated. This endpoint is deprecated - use the V2 endpoints instead. Create a Datadog-Amazon Web Services integration. Using the POST method updates your…
  • DELETEDelete an AWS integration/api/v1/integration/awsDeprecated. This endpoint is deprecated - use the V2 endpoints instead. Delete a Datadog-AWS integration matching the specified account_id and role_name…
  • GETList namespace rules/api/v1/integration/aws/available_namespace_rulesDeprecated. This endpoint is deprecated - use the V2 endpoints instead. List all namespace rules for a given Datadog-AWS integration. This endpoint takes no…
  • GETGet all Amazon EventBridge sources/api/v1/integration/aws/event_bridgeDeprecated. This endpoint is deprecated - use the V2 endpoints instead. Get all Amazon EventBridge sources.
  • POSTCreate an Amazon EventBridge source/api/v1/integration/aws/event_bridgeDeprecated. This endpoint is deprecated - use the V2 endpoints instead. Create an Amazon EventBridge source.
  • DELETEDelete an Amazon EventBridge source/api/v1/integration/aws/event_bridgeDeprecated. This endpoint is deprecated - use the V2 endpoints instead. Delete an Amazon EventBridge source.
  • GETGet all AWS tag filters/api/v1/integration/aws/filtering?account_id=stringDeprecated. Get all AWS tag filters.
  • POSTSet an AWS tag filter/api/v1/integration/aws/filteringDeprecated. Set an AWS tag filter.
  • DELETEDelete a tag filtering entry/api/v1/integration/aws/filteringDeprecated. Delete a tag filtering entry.
  • PUTGenerate a new external ID/api/v1/integration/aws/generate_new_external_idDeprecated. This endpoint is deprecated - use the V2 endpoints instead. Generate a new AWS external ID for a given AWS account ID and role name pair.

AWS Logs Integration

  • GETList all AWS Logs integrations/api/v1/integration/aws/logsDeprecated. List all Datadog-AWS Logs integrations configured in your Datadog account.
  • POSTAdd AWS Log Lambda ARN/api/v1/integration/aws/logsDeprecated. This endpoint is deprecated. Attach the Lambda ARN of the Lambda created for the Datadog-AWS log collection to your AWS account ID to enable log…
  • DELETEDelete an AWS Logs integration/api/v1/integration/aws/logsDeprecated. This endpoint is deprecated. Delete a Datadog-AWS logs configuration by removing the specific Lambda ARN associated with a given AWS account.
  • POSTCheck that an AWS Lambda Function exists/api/v1/integration/aws/logs/check_asyncDeprecated. This endpoint is deprecated. Test if permissions are present to add a log-forwarding triggers for the given services and AWS account. The input is…
  • GETGet list of AWS log ready services/api/v1/integration/aws/logs/servicesDeprecated. This endpoint is deprecated - use the V2 endpoint instead. Get the list of current AWS services that Datadog offers automatic log collection. Use…
  • POSTEnable an AWS Logs integration/api/v1/integration/aws/logs/servicesDeprecated. Enable automatic log collection for a list of services. This should be run after running CreateAWSLambdaARN to save the configuration.
  • POSTCheck permissions for log services/api/v1/integration/aws/logs/services_asyncDeprecated. This endpoint is deprecated. Test if permissions are present to add log-forwarding triggers for the given services and AWS account. Input is the…

Authentication

  • GETValidate API key/api/v1/validateCheck if the API key (not the APP key) is valid. If invalid, a 403 is returned.

Azure Integration

  • GETList all Azure integrations/api/v1/integration/azureList all Datadog-Azure integrations configured in your Datadog account.
  • PUTUpdate an Azure integration/api/v1/integration/azureUpdate a Datadog-Azure integration. Requires an existing tenant_name and client_id. Any other fields supplied will overwrite existing values. To overwrite…
  • POSTCreate an Azure integration/api/v1/integration/azureCreate a Datadog-Azure integration. Using the POST method updates your integration configuration by adding your new configuration to the existing one in your…
  • DELETEDelete an Azure integration/api/v1/integration/azureDelete a given Datadog-Azure integration from your Datadog account.
  • POSTUpdate Azure integration host filters/api/v1/integration/azure/host_filtersUpdate the defined list of host filters for a given Datadog-Azure integration.

Dashboard Lists

  • GETGet all dashboard lists/api/v1/dashboard/lists/manualFetch all of your existing dashboard list definitions.
  • POSTCreate a dashboard list/api/v1/dashboard/lists/manualCreate an empty dashboard list.
  • GETGet a dashboard list/api/v1/dashboard/lists/manual/:list_idFetch an existing dashboard list's definition.
  • PUTUpdate a dashboard list/api/v1/dashboard/lists/manual/:list_idUpdate the name of a dashboard list.
  • DELETEDelete a dashboard list/api/v1/dashboard/lists/manual/:list_idDelete a dashboard list.

Dashboards

  • GETGet all dashboards/api/v1/dashboard?filter[shared]=true&filter[deleted]=true&count=100&start=0Get all dashboards. Note: This query will only return custom created or cloned dashboards. This query will not return preset dashboards.
  • POSTCreate a new dashboard/api/v1/dashboardCreate a dashboard using the specified options. When defining queries in your widgets, take note of which queries should have the as_count() or as_rate()…
  • DELETEDelete dashboards/api/v1/dashboardDelete dashboards using the specified IDs. If there are any failures, no dashboards will be deleted (partial success is not allowed).
  • PATCHRestore deleted dashboards/api/v1/dashboardRestore dashboards using the specified IDs. If there are any failures, no dashboards will be restored (partial success is not allowed).
  • POSTCreate a shared dashboard/api/v1/dashboard/publicShare a specified private dashboard, generating a URL at which it can be publicly viewed.
  • GETGet a shared dashboard/api/v1/dashboard/public/:tokenFetch an existing shared dashboard's sharing metadata associated with the specified token.
  • PUTUpdate a shared dashboard/api/v1/dashboard/public/:tokenUpdate a shared dashboard associated with the specified token.
  • DELETERevoke a shared dashboard URL/api/v1/dashboard/public/:tokenRevoke the public URL for a dashboard (rendering it private) associated with the specified token.
  • GETGet all invitations for a shared dashboard/api/v1/dashboard/public/:token/invitation?page_size=0&page_number=0Describe the invitations that exist for the given shared dashboard (paginated).
  • POSTSend shared dashboard invitation email/api/v1/dashboard/public/:token/invitationSend emails to specified email addresses containing links to access a given authenticated shared dashboard. Email addresses must already belong to the…
  • DELETERevoke shared dashboard invitations/api/v1/dashboard/public/:token/invitationRevoke previously sent invitation emails and active sessions used to access a given shared dashboard for specific email addresses.
  • GETGet a dashboard/api/v1/dashboard/:dashboard_idGet a dashboard using the specified ID.
  • PUTUpdate a dashboard/api/v1/dashboard/:dashboard_idUpdate a dashboard using the specified ID.
  • DELETEDelete a dashboard/api/v1/dashboard/:dashboard_idDelete a dashboard using the specified ID.

Downtimes

  • GETGet all downtimes/api/v1/downtime?current_only=true&with_creator=trueDeprecated. Get all scheduled downtimes. Note: This endpoint has been deprecated. Please use v2 endpoints.
  • POSTSchedule a downtime/api/v1/downtimeDeprecated. Schedule a downtime. Note: This endpoint has been deprecated. Please use v2 endpoints.
  • POSTCancel downtimes by scope/api/v1/downtime/cancel/by_scopeDeprecated. Delete all downtimes that match the scope of X. Note: This only interacts with Downtimes created using v1 endpoints. This endpoint has been…
  • GETGet a downtime/api/v1/downtime/:downtime_idDeprecated. Get downtime detail by downtime_id. Note: This endpoint has been deprecated. Please use v2 endpoints.
  • PUTUpdate a downtime/api/v1/downtime/:downtime_idDeprecated. Update a single downtime by downtime_id. Note: This endpoint has been deprecated. Please use v2 endpoints.
  • DELETECancel a downtime/api/v1/downtime/:downtime_idDeprecated. Cancel a downtime. Note: This endpoint has been deprecated. Please use v2 endpoints.
  • GETGet active downtimes for a monitor/api/v1/monitor/:monitor_id/downtimesDeprecated. Get all active v1 downtimes for the specified monitor. Note: This endpoint has been deprecated. Please use v2 endpoints.

Events

  • GETGet a list of events/api/v1/events?start=0&end=0&priority=normal&sources=string&tags=host:host0&unaggregated=true&exclude_aggregate=true&page=0The event stream can be queried and filtered by time, priority, sources and tags. Notes: If the event you’re querying contains markdown formatting of any…
  • POSTPost an event/api/v1/eventsDeprecated. This endpoint is deprecated and is available only to organizations that have previously used it. Use the V2 endpoint instead. This endpoint allows…
  • GETGet an event/api/v1/events/:event_idThis endpoint allows you to query for event details. Note: If the event you’re querying contains markdown formatting of any kind, you may see characters such…

GCP Integration

  • GETList all GCP integrations/api/v1/integration/gcpDeprecated. This endpoint is deprecated – use the V2 endpoints instead. List all Datadog-GCP integrations configured in your Datadog account.
  • PUTUpdate a GCP integration/api/v1/integration/gcpDeprecated. This endpoint is deprecated – use the V2 endpoints instead. Update a Datadog-GCP integrations host_filters and/or auto-mute. Requires a project_id…
  • POSTCreate a GCP integration/api/v1/integration/gcpDeprecated. This endpoint is deprecated – use the V2 endpoints instead. Create a Datadog-GCP integration.
  • DELETEDelete a GCP integration/api/v1/integration/gcpDeprecated. This endpoint is deprecated – use the V2 endpoints instead. Delete a given Datadog-GCP integration.

Hosts

  • POSTMute a host/api/v1/host/:host_name/muteMute a host. Note: This creates a Downtime V2 for the host.
  • POSTUnmute a host/api/v1/host/:host_name/unmuteUnmutes a host. This endpoint takes no JSON arguments.
  • GETGet all hosts for your organization/api/v1/hosts?filter=string&sort_field=string&sort_dir=string&start=0&count=0&from=0&include_muted_hosts_data=true&include_hosts_metadata=trueThis endpoint allows searching for hosts by name, alias, or tag. Hosts live within the past 3 hours are included by default. Retention is 7 days. Results are…
  • GETGet the total number of active hosts/api/v1/hosts/totals?from=0This endpoint returns the total number of active and up hosts in your Datadog account. Active means the host has reported in the past hour, and up means it…

IP Ranges

  • GETList IP Rangeshttps://ip-ranges.datadoghq.com/Get information about Datadog IP ranges.

Key Management

  • GETGet all API keys/api/v1/api_keyDeprecated. This endpoint is deprecated. Use Get all API keys (GET /api/v2/api_keys) instead. Get all API keys available for your account. Note: This endpoint…
  • POSTCreate an API key/api/v1/api_keyDeprecated. This endpoint is deprecated. Use Create an API key (POST /api/v2/api_keys) instead. Creates an API key with a given name. Note: This endpoint is…
  • GETGet API key/api/v1/api_key/:keyDeprecated. This endpoint is deprecated. Use Get API key (GET /api/v2/api_keys/{api_key_id}) instead. Get a given API key. Note: This endpoint is disabled for…
  • PUTEdit an API key/api/v1/api_key/:keyDeprecated. This endpoint is deprecated. Use Edit an API key (PATCH /api/v2/api_keys/{api_key_id}) instead. Edit an API key name. Note: This endpoint is…
  • DELETEDelete an API key/api/v1/api_key/:keyDeprecated. This endpoint is deprecated. Use Delete an API key (DELETE /api/v2/api_keys/{api_key_id}) instead. Delete a given API key. Note: This endpoint is…
  • GETGet all application keys/api/v1/application_keyDeprecated. This endpoint is deprecated. To list your own application keys, use Get all application keys owned by current user (GET…
  • POSTCreate an application key/api/v1/application_keyDeprecated. This endpoint is deprecated. Use Create an application key for current user (POST /api/v2/current_user/application_keys) instead. Create an…
  • GETGet an application key/api/v1/application_key/:keyDeprecated. This endpoint is deprecated. To get your own application key, use Get one application key owned by current user (GET…
  • PUTEdit an application key/api/v1/application_key/:keyDeprecated. This endpoint is deprecated. To edit your own application key, use Edit an application key owned by current user (PATCH…
  • DELETEDelete an application key/api/v1/application_key/:keyDeprecated. This endpoint is deprecated. To delete your own application key, use Delete an application key owned by current user (DELETE…

Logs

  • POSTSearch logs/api/v1/logs-queries/listList endpoint returns logs that match a log search query. [Results are paginated][1]. If you are considering archiving logs for your organization, consider…
  • POSTSend logshttps://http-intake.logs.datadoghq.com/v1/input?ddtags=env:prod,user:my-userDeprecated. Send your logs to your Datadog platform over HTTP. Limits per HTTP request are: Maximum content size per payload (uncompressed): 5MB Maximum size…

Logs Indexes

  • GETGet indexes order/api/v1/logs/config/index-orderGet the current order of your log indexes. This endpoint takes no JSON arguments.
  • PUTUpdate indexes order/api/v1/logs/config/index-orderThis endpoint updates the index order of your organization. It returns the index order object passed in the request body when the request is successful.
  • GETGet all indexes/api/v1/logs/config/indexesThe Index object describes the configuration of a log index. This endpoint returns an array of the LogIndex objects of your organization.
  • POSTCreate an index/api/v1/logs/config/indexesCreates a new index. Returns the Index object passed in the request body when the request is successful.
  • GETGet an index/api/v1/logs/config/indexes/:nameGet one log index from your organization. This endpoint takes no JSON arguments.
  • PUTUpdate an index/api/v1/logs/config/indexes/:nameUpdate an index as identified by its name. Returns the Index object passed in the request body when the request is successful. Using the PUT method updates…
  • DELETEDelete an index/api/v1/logs/config/indexes/:nameDelete an existing index from your organization. Index deletions are permanent and cannot be reverted. You cannot recreate an index with the same name as…

Logs Pipelines

  • GETGet pipeline order/api/v1/logs/config/pipeline-orderGet the current order of your pipelines. This endpoint takes no JSON arguments.
  • PUTUpdate pipeline order/api/v1/logs/config/pipeline-orderUpdate the order of your pipelines. Since logs are processed sequentially, reordering a pipeline may change the structure and content of the data processed by…
  • GETGet all pipelines/api/v1/logs/config/pipelinesGet all pipelines from your organization. This endpoint takes no JSON arguments.
  • POSTCreate a pipeline/api/v1/logs/config/pipelinesCreate a pipeline in your organization.
  • GETGet a pipeline/api/v1/logs/config/pipelines/:pipeline_idGet a specific pipeline from your organization. This endpoint takes no JSON arguments.
  • PUTUpdate a pipeline/api/v1/logs/config/pipelines/:pipeline_idUpdate a given pipeline configuration to change it’s processors or their order. Note: Using this method updates your pipeline configuration by replacing your…
  • DELETEDelete a pipeline/api/v1/logs/config/pipelines/:pipeline_idDelete a given pipeline from your organization. This endpoint takes no JSON arguments.

Metrics

  • POSTSubmit distribution points/api/v1/distribution_pointsThe distribution points end-point allows you to post distribution data that can be graphed on Datadog’s dashboards.
  • GETGet active metrics list/api/v1/metrics?from=0&host=string&tag_filter=env IN (staging,test) AND service:webGet the list of actively reporting metrics from a given time until now.
  • GETGet metric metadata/api/v1/metrics/:metric_nameGet metadata about a specific metric.
  • PUTEdit metric metadata/api/v1/metrics/:metric_nameEdit metadata of a specific metric. Find out more about supported types.
  • GETQuery timeseries points/api/v1/query?from=0&to=0&query=stringQuery timeseries points. Datadog recommends using the v2 /api/v2/query/timeseries endpoint over this endpoint for querying timeseries data.
  • GETSearch metrics/api/v1/search?q=stringDeprecated. Note: This endpoint is deprecated. Use /api/v2/metrics instead. Search for metrics from the last 24 hours in Datadog.
  • POSTSubmit metrics/api/v1/seriesThe metrics end-point allows you to post time-series data that can be graphed on Datadog’s dashboards. The maximum payload size is 3.2 megabytes (3200000…

Monitors

  • GETGet all monitors/api/v1/monitor?group_states=alert&name=string&tags=host:host0&monitor_tags=service:my-app&with_downtimes=true&id_offset=0&page=0&page_size=20Get all monitors from your organization.
  • POSTCreate a monitor/api/v1/monitorCreate a monitor using the specified options. Monitor Types The type of monitor chosen from: anomaly: query alert APM: query alert or trace-analytics alert…
  • GETCheck if a monitor can be deleted/api/v1/monitor/can_delete?monitor_ids=666486743Check if the given monitors can be deleted.
  • GETMonitors group search/api/v1/monitor/groups/search?query=string&page=0&per_page=30&sort=stringSearch and filter your monitor groups details.
  • GETMonitors search/api/v1/monitor/search?query=string&page=0&per_page=30&sort=stringSearch and filter your monitors details.
  • POSTValidate a monitor/api/v1/monitor/validateValidate the monitor provided in the request. Note: Log monitors require an unscoped App Key and logs_read_data permission.
  • GETGet a monitor's details/api/v1/monitor/:monitor_id?group_states=string&with_downtimes=true&with_assets=trueGet details about the specified monitor from your organization.
  • PUTEdit a monitor/api/v1/monitor/:monitor_idEdit the specified monitor.
  • DELETEDelete a monitor/api/v1/monitor/:monitor_id?force=falseDelete the specified monitor
  • POSTValidate an existing monitor/api/v1/monitor/:monitor_id/validateValidate the monitor provided in the request. Note: Log monitors require an unscoped App Key and logs_read_data permission.

Notebooks

  • GETGet all notebooks/api/v1/notebooks?author_handle=test@datadoghq.com&exclude_author_handle=test@datadoghq.com&start=0&count=5&sort_field=modified&sort_dir=desc&query=postmortem&include_cells=false&is_template=false&type=investigationGet all notebooks. This can also be used to search for notebooks with a particular query in the notebook name or author handle.
  • POSTCreate a notebook/api/v1/notebooksCreate a notebook using the specified options.
  • GETGet a notebook/api/v1/notebooks/:notebook_idGet a notebook using the specified notebook ID.
  • PUTUpdate a notebook/api/v1/notebooks/:notebook_idUpdate a notebook using the specified ID.
  • DELETEDelete a notebook/api/v1/notebooks/:notebook_idDelete a notebook using the specified ID.

Organizations

  • GETList your managed organizations/api/v1/orgThis endpoint returns data on your top-level organization.
  • POSTCreate a child organization/api/v1/orgCreate a child organization. This endpoint requires the multi-organization account feature and must be enabled by contacting support. Once a new child…
  • GETGet organization information/api/v1/org/:public_idGet organization information.
  • PUTUpdate your organization/api/v1/org/:public_idUpdate your organization.
  • POSTSpin-off Child Organization/api/v1/org/:public_id/downgradeOnly available for MSP customers. Removes a child organization from the hierarchy of the master organization and places the child organization on a 30-day…
  • POSTUpload IdP metadata/api/v1/org/:public_id/idp_metadataThere are a couple of options for updating the Identity Provider (IdP) metadata from your SAML IdP. * Multipart Form-Data: Post the IdP metadata file using a…

PagerDuty Integration

  • POSTCreate a new service object/api/v1/integration/pagerduty/configuration/servicesCreate a new service object in the PagerDuty integration.
  • GETGet a single service object/api/v1/integration/pagerduty/configuration/services/:service_nameGet service name in the Datadog-PagerDuty integration.
  • PUTUpdate a single service object/api/v1/integration/pagerduty/configuration/services/:service_nameUpdate a single service object in the Datadog-PagerDuty integration.
  • DELETEDelete a single service object/api/v1/integration/pagerduty/configuration/services/:service_nameDelete a single service object in the Datadog-PagerDuty integration.

Security Monitoring

  • PATCHAdd a security signal to an incident/api/v1/security_analytics/signals/:signal_id/add_to_incidentAdd a security signal to an incident. This makes it possible to search for signals by incident within the signal explorer and to view the signals on the…
  • PATCHModify the triage assignee of a security signal/api/v1/security_analytics/signals/:signal_id/assigneeDeprecated. This endpoint is deprecated - Modify the triage assignee of a security signal.
  • PATCHChange the triage state of a security signal/api/v1/security_analytics/signals/:signal_id/stateDeprecated. This endpoint is deprecated - Change the triage state of a security signal.

Service Checks

  • POSTSubmit a Service Check/api/v1/check_runSubmit a list of Service Checks. Notes: A valid API key is required. Service checks can be submitted up to 10 minutes in the past.

Service Level Objective Corrections

  • GETGet all SLO corrections/api/v1/slo/correction?offset=0&limit=25Get all Service Level Objective corrections.
  • POSTCreate an SLO correction/api/v1/slo/correctionCreate an SLO correction. Use slo_id to apply the correction to a single SLO, or slo_query to apply the correction to SLOs that match a query. Exactly one of…
  • GETGet an SLO correction for an SLO/api/v1/slo/correction/:slo_correction_idGet an SLO correction.
  • DELETEDelete an SLO correction/api/v1/slo/correction/:slo_correction_idPermanently delete the specified SLO correction object.
  • PATCHUpdate an SLO correction/api/v1/slo/correction/:slo_correction_idUpdate the specified SLO correction object.

Service Level Objectives

  • GETGet all SLOs/api/v1/slo?ids=id1, id2, id3&query=monitor&tags_query=env:prod&metrics_query=aws.elb.request_count&limit=1000&offset=0&is_deleted=trueGet a list of service level objective objects for your organization.
  • POSTCreate an SLO object/api/v1/sloCreate a service level objective object.
  • POSTBulk Delete SLO Timeframes/api/v1/slo/bulk_deleteDelete (or partially delete) multiple service level objective objects. This endpoint facilitates deletion of one or more thresholds for one or more service…
  • GETCheck if SLOs can be safely deleted/api/v1/slo/can_delete?ids=id1, id2, id3Check if an SLO can be safely deleted. For example, assure an SLO can be deleted without disrupting a dashboard.
  • GETSearch for SLOs/api/v1/slo/search?query=string&page[size]=0&page[number]=0&include_facets=trueGet a list of service level objective objects for your organization.
  • GETGet an SLO's details/api/v1/slo/:slo_id?with_configured_alert_ids=trueGet a service level objective object.
  • PUTUpdate an SLO/api/v1/slo/:slo_idUpdate the specified service level objective object.
  • DELETEDelete an SLO/api/v1/slo/:slo_id?force=stringPermanently delete the specified service level objective object. If an SLO is used in a dashboard, the DELETE /v1/slo/ endpoint returns a 409 conflict error…
  • GETGet Corrections For an SLO/api/v1/slo/:slo_id/correctionsGet corrections applied to an SLO
  • GETGet an SLO's history/api/v1/slo/:slo_id/history?from_ts=0&to_ts=0&target=0.0&apply_correction=trueGet a specific SLO’s history, regardless of its SLO type. The detailed history data is structured according to the source data type. For example, metric data…

Slack Integration

  • GETGet all channels in a Slack integration/api/v1/integration/slack/configuration/accounts/:account_name/channelsGet a list of all channels configured for your Datadog-Slack integration.
  • POSTCreate a Slack integration channel/api/v1/integration/slack/configuration/accounts/:account_name/channelsAdd a channel to your Datadog-Slack integration.
  • GETGet a Slack integration channel/api/v1/integration/slack/configuration/accounts/:account_name/channels/:channel_nameGet a channel configured for your Datadog-Slack integration.
  • DELETERemove a Slack integration channel/api/v1/integration/slack/configuration/accounts/:account_name/channels/:channel_nameRemove a channel from your Datadog-Slack integration.
  • PATCHUpdate a Slack integration channel/api/v1/integration/slack/configuration/accounts/:account_name/channels/:channel_nameUpdate a channel used in your Datadog-Slack integration.

Snapshots

  • GETTake graph snapshots/api/v1/graph/snapshot?metric_query=string&start=0&end=0&event_query=string&graph_def=string&title=string&height=0&width=0Take graph snapshots. Snapshots are PNG images generated by rendering a specified widget in a web page and capturing it once the data is available. The image…

Synthetics

  • GETGet details of batch/api/v1/synthetics/ci/batch/:batch_idGet a batch's updated details.
  • GETGet all locations (public and private)/api/v1/synthetics/locationsGet the list of public and private locations available for Synthetic tests. No arguments required.
  • POSTCreate a private location/api/v1/synthetics/private-locationsCreate a new Synthetic private location.
  • GETGet a private location/api/v1/synthetics/private-locations/:location_idGet a Synthetic private location.
  • PUTEdit a private location/api/v1/synthetics/private-locations/:location_idEdit a Synthetic private location.
  • DELETEDelete a private location/api/v1/synthetics/private-locations/:location_idDelete a Synthetic private location.
  • GETGet the default locations/api/v1/synthetics/settings/default_locationsGet the default locations settings.
  • GETGet the list of all Synthetic tests/api/v1/synthetics/tests?page_size=100&page_number=0Get the list of all Synthetic tests.
  • POSTCreate an API test/api/v1/synthetics/tests/apiCreate a Synthetic API test.
  • GETGet an API test/api/v1/synthetics/tests/api/:public_idGet the detailed configuration associated with a Synthetic API test.
  • PUTEdit an API test/api/v1/synthetics/tests/api/:public_idEdit the configuration of a Synthetic API test.
  • POSTCreate a browser test/api/v1/synthetics/tests/browserCreate a Synthetic browser test.
  • GETGet a browser test/api/v1/synthetics/tests/browser/:public_idGet the detailed configuration (including steps) associated with a Synthetic browser test.
  • PUTEdit a browser test/api/v1/synthetics/tests/browser/:public_idEdit the configuration of a Synthetic browser test.
  • GETGet a browser test's latest results summaries/api/v1/synthetics/tests/browser/:public_id/results?from_ts=0&to_ts=0&probe_dc=stringGet the last 150 test results summaries for a given Synthetic browser test.
  • GETGet a browser test result/api/v1/synthetics/tests/browser/:public_id/results/:result_idGet a specific full result from a given Synthetic browser test.
  • POSTDelete tests/api/v1/synthetics/tests/deleteDelete multiple Synthetic tests by ID.
  • POSTCreate a mobile test/api/v1/synthetics/tests/mobileCreate a Synthetic mobile test.
  • GETGet a mobile test/api/v1/synthetics/tests/mobile/:public_idGet the detailed configuration associated with a Synthetic mobile test.
  • PUTEdit a mobile test/api/v1/synthetics/tests/mobile/:public_idEdit the configuration of a Synthetic mobile test.
  • GETSearch Synthetic tests/api/v1/synthetics/tests/search?text=string&include_full_config=true&facets_only=true&start=0&count=50&sort=name,ascSearch for Synthetic tests.
  • POSTTrigger Synthetic tests/api/v1/synthetics/tests/triggerTrigger a set of Synthetic tests.
  • POSTTrigger tests from CI/CD pipelines/api/v1/synthetics/tests/trigger/ciTrigger a set of Synthetic tests for continuous integration.
  • POSTFetch uptime for multiple tests/api/v1/synthetics/tests/uptimesFetch uptime for multiple Synthetic tests by ID.
  • GETGet a test configuration/api/v1/synthetics/tests/:public_idGet the detailed configuration associated with a Synthetic test.
  • PATCHPatch a Synthetic test/api/v1/synthetics/tests/:public_idPatch the configuration of a Synthetic test with partial data.
  • GETGet an API test's latest results summaries/api/v1/synthetics/tests/:public_id/results?from_ts=0&to_ts=0&probe_dc=stringGet the last 150 test results summaries for a given Synthetic API test.
  • GETGet an API test result/api/v1/synthetics/tests/:public_id/results/:result_idGet a specific full result from a given Synthetic API test.
  • PUTPause or start a test/api/v1/synthetics/tests/:public_id/statusPause or start a Synthetic test by changing the status.
  • GETGet all global variables/api/v1/synthetics/variablesGet the list of all Synthetic global variables.
  • POSTCreate a global variable/api/v1/synthetics/variablesCreate a Synthetic global variable.
  • GETGet a global variable/api/v1/synthetics/variables/:variable_idGet the detailed configuration of a global variable.
  • PUTEdit a global variable/api/v1/synthetics/variables/:variable_idEdit a Synthetic global variable.
  • DELETEDelete a global variable/api/v1/synthetics/variables/:variable_idDelete a Synthetic global variable.

Tags

  • GETGet All Host Tags/api/v1/tags/hosts?source=stringReturns a mapping of tags to hosts. For each tag, the response returns a list of host names that contain this tag. There is a restriction of 10k total host…
  • GETGet Host Tags/api/v1/tags/hosts/:host_name?source=stringReturn the list of tags that apply to a given host.
  • PUTUpdate host tags/api/v1/tags/hosts/:host_name?source=stringThis endpoint allows you to update/replace all tags in an integration source with those supplied in the request.
  • POSTAdd tags to a host/api/v1/tags/hosts/:host_name?source=chefThis endpoint allows you to add new tags to a host, optionally specifying what source these tags come from. If tags already exist, appends new tags to the tag…
  • DELETERemove host tags/api/v1/tags/hosts/:host_name?source=stringThis endpoint allows you to remove all tags for a single host. If no source is specified, only deletes from the source "User".

Usage Metering

  • GETGet the list of available daily custom reports/api/v1/daily_custom_reports?page[size]=0&page[number]=0&sort_dir=desc&sort=start_dateDeprecated. Get daily custom reports. Note: This endpoint will be fully deprecated on December 1, 2022. Refer to Migrating from v1 to v2 of the Usage…
  • GETGet specified daily custom reports/api/v1/daily_custom_reports/:report_idDeprecated. Get specified daily custom reports. Note: This endpoint will be fully deprecated on December 1, 2022. Refer to Migrating from v1 to v2 of the…
  • GETGet the list of available monthly custom reports/api/v1/monthly_custom_reports?page[size]=0&page[number]=0&sort_dir=desc&sort=start_dateDeprecated. Get monthly custom reports. Note: This endpoint will be fully deprecated on December 1, 2022. Refer to Migrating from v1 to v2 of the Usage…
  • GETGet specified monthly custom reports/api/v1/monthly_custom_reports/:report_idDeprecated. Get specified monthly custom reports. Note: This endpoint will be fully deprecated on December 1, 2022. Refer to Migrating from v1 to v2 of the…
  • GETGet hourly usage for analyzed logs/api/v1/usage/analyzed_logs?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for analyzed logs (Security Monitoring). Note: This endpoint has been deprecated. Hourly usage data for all products is now…
  • GETGet hourly usage for audit logs/api/v1/usage/audit_logs?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for audit logs. Note: This endpoint has been deprecated.
  • GETGet hourly usage for Lambda/api/v1/usage/aws_lambda?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for Lambda. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly usage…
  • GETGet billable usage across your account/api/v1/usage/billable-summary?month=2024-01-01T00:00:00Z&include_connected_accounts=falseGet billable usage across your account. This endpoint is only accessible for parent-level organizations.
  • GETGet hourly usage for CI visibility/api/v1/usage/ci-app?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for CI visibility (tests, pipeline, and spans). Note: This endpoint has been deprecated. Hourly usage data for all products is…
  • GETGet hourly usage for CSM Pro/api/v1/usage/cspm?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for cloud security management (CSM) pro. Note: This endpoint has been deprecated. Hourly usage data for all products is now…
  • GETGet hourly usage for cloud workload security/api/v1/usage/cws?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for cloud workload security. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the…
  • GETGet hourly usage for database monitoring/api/v1/usage/dbm?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for database monitoring Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get…
  • GETGet hourly usage for Fargate/api/v1/usage/fargate?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for Fargate. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly usage…
  • GETGet hourly usage for hosts and containers/api/v1/usage/hosts?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for hosts and containers. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get…
  • GETGet hourly usage attribution/api/v1/usage/hourly-attribution?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00Z&usage_type=api_usage&next_record_id=string&tag_breakdown_keys=string&include_descendants=trueGet hourly usage attribution. Multi-region data is available starting March 1, 2023. Note: All estimated_* usage types will be deprecated on February 1, 2027.…
  • GETGet hourly usage for incident management/api/v1/usage/incident-management?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for incident management. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get…
  • GETGet hourly usage for indexed spans/api/v1/usage/indexed-spans?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for indexed spans. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly…
  • GETGet hourly usage for ingested spans/api/v1/usage/ingested-spans?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for ingested spans. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get…
  • GETGet hourly usage for IoT/api/v1/usage/iot?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for IoT. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly usage by…
  • GETGet hourly usage for logs/api/v1/usage/logs?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for logs. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly usage by…
  • GETGet hourly logs usage by retention/api/v1/usage/logs-by-retention?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for indexed logs by retention period. Note: This endpoint has been deprecated. Hourly usage data for all products is now…
  • GETGet hourly usage for logs by index/api/v1/usage/logs_by_index?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00Z&index_name=stringGet hourly usage for logs by index.
  • GETGet monthly usage attribution/api/v1/usage/monthly-attribution?start_month=2024-01-01T00:00:00Z&end_month=2024-01-01T00:00:00Z&fields=api_usage&sort_direction=desc&sort_name=api_usage&tag_breakdown_keys=string&next_record_id=string&include_descendants=trueGet monthly usage attribution. Multi-region data is available starting March 1, 2023. Note: All estimated_* usage types will be deprecated on February 1,…
  • GETget hourly usage for network flows/api/v1/usage/network_flows?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for network flows. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly…
  • GETGet hourly usage for network hosts/api/v1/usage/network_hosts?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for network hosts. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly…
  • GETGet hourly usage for online archive/api/v1/usage/online-archive?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for online archive. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get…
  • GETGet hourly usage for profiled hosts/api/v1/usage/profiling?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for profiled hosts. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get…
  • GETGet hourly usage for RUM units/api/v1/usage/rum?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for RUM Units. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly…
  • GETGet hourly usage for RUM sessions/api/v1/usage/rum_sessions?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00Z&type=stringDeprecated. Get hourly usage for RUM Sessions. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly…
  • GETGet hourly usage for sensitive data scanner/api/v1/usage/sds?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for sensitive data scanner. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the…
  • GETGet hourly usage for SNMP devices/api/v1/usage/snmp?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for SNMP devices. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get hourly…
  • GETGet usage across your account/api/v1/usage/summary?start_month=2024-01-01T00:00:00Z&end_month=2024-01-01T00:00:00Z&include_org_details=true&include_connected_accounts=falseGet all usage across your account. For SDK users only: all fields on UsageSummaryResponse, UsageSummaryDate, and UsageSummaryDateOrg are accessible through…
  • GETGet hourly usage for synthetics checks/api/v1/usage/synthetics?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for synthetics checks. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get…
  • GETGet hourly usage for synthetics API checks/api/v1/usage/synthetics_api?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for synthetics API checks. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the…
  • GETGet hourly usage for synthetics browser checks/api/v1/usage/synthetics_browser?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for synthetics browser checks. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in…
  • GETGet hourly usage for custom metrics/api/v1/usage/timeseries?start_hr=2024-01-01T00:00:00Z&end_hr=2024-01-01T00:00:00ZDeprecated. Get hourly usage for custom metrics. Note: This endpoint has been deprecated. Hourly usage data for all products is now available in the Get…
  • GETGet all custom metrics by hourly average/api/v1/usage/top_avg_metrics?month=2024-01-01T00:00:00Z&day=2024-01-01T00:00:00Z&names=string&limit=500&next_record_id=stringGet all custom metrics by hourly average. Use the month parameter to get a month-to-date data resolution or use the day parameter to get a daily resolution.…

Users

  • GETList all users/api/v1/userList all users for your organization.
  • POSTCreate a user/api/v1/userCreate a user for your organization. Note: Users can only be created with the admin access role if application keys belong to administrators.
  • GETGet user details/api/v1/user/:user_handleGet a user's details.
  • PUTUpdate a user/api/v1/user/:user_handleUpdate a user information. Note: It can only be used with application keys belonging to administrators.
  • DELETEDisable a user/api/v1/user/:user_handleDelete a user from an organization. Note: This endpoint can only be used with application keys belonging to administrators.

Webhooks Integration

  • POSTCreate a custom variable/api/v1/integration/webhooks/configuration/custom-variablesCreates an endpoint with the name <CUSTOM_VARIABLE_NAME>.
  • GETGet a custom variable/api/v1/integration/webhooks/configuration/custom-variables/:custom_variable_nameShows the content of the custom variable with the name <CUSTOM_VARIABLE_NAME>. If the custom variable is secret, the value does not return in the response…
  • PUTUpdate a custom variable/api/v1/integration/webhooks/configuration/custom-variables/:custom_variable_nameUpdates the endpoint with the name <CUSTOM_VARIABLE_NAME>.
  • DELETEDelete a custom variable/api/v1/integration/webhooks/configuration/custom-variables/:custom_variable_nameDeletes the endpoint with the name <CUSTOM_VARIABLE_NAME>.
  • POSTCreate a webhooks integration/api/v1/integration/webhooks/configuration/webhooksCreates an endpoint with the name <WEBHOOK_NAME>.
  • GETGet a webhook integration/api/v1/integration/webhooks/configuration/webhooks/:webhook_nameGets the content of the webhook with the name <WEBHOOK_NAME>.
  • PUTUpdate a webhook/api/v1/integration/webhooks/configuration/webhooks/:webhook_nameUpdates the endpoint with the name <WEBHOOK_NAME>.
  • DELETEDelete a webhook/api/v1/integration/webhooks/configuration/webhooks/:webhook_nameDeletes the endpoint with the name <WEBHOOK NAME>. This action cannot be undone.

API details

Base URL
https://{subdomain}.{site}
https://{subdomain}.{site}
Authentication
OAuth 2.0 (authorization code flow) with 69 scopes
An API key in the DD-API-KEY header
An API key in the api_key query parameter
An API key in the DD-APPLICATION-KEY header
An API key in the application_key query parameter
A bearer token in the Authorization header
Operations
235 operations on 150 pathsGET 117POST 53PUT 30DELETE 28PATCH 7
76 marked deprecated
Main resources
Usage Metering 37Synthetics 34Dashboards 14AWS Integration 12Key Management 10Monitors 10Service Level Objectives 10Webhooks Integration 8AWS Logs Integration 7Downtimes 7
Response formats
application/json application/json;datetime-format=rfc3339 text/json
Description format
OpenAPI 3.0.0, API version 1.0

How to test the Datadog API V1 Collection in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Datadog API V1 Collection collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 69 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List all AWS integrations” (GET /api/v1/integration/aws?account_id=string&role_name=string&access_key_id=string), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Datadog API V1 Collection?

Collection of all Datadog Public endpoints. It is listed under Developer tools and has 235 endpoints.

Who publishes the Datadog API V1 Collection?

It is listed from Datadog's public API description (an OpenAPI document), not published by Datadog on Swastik Codes. Anyone who controls datadoghq.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Datadog API V1 Collection?

Its description lists 2 base URLs: https://{subdomain}.{site}, https://{subdomain}.{site}. The first is the usual one; the others are typically sandbox or regional servers.

How do I authenticate with the Datadog API V1 Collection?

It accepts 6 methods: OAuth 2.0 (authorization code flow) with 69 scopes; an API key in the DD-API-KEY header; an API key in the api_key query parameter; an API key in the DD-APPLICATION-KEY header; an API key in the application_key query parameter; A bearer token in the Authorization header.

How many endpoints does the Datadog API V1 Collection have?

235 operations on 150 paths (117 GET, 53 POST, 30 PUT, 28 DELETE, 7 PATCH). The largest groups are Usage Metering, Synthetics, Dashboards, AWS Integration.

Is forking the Datadog API V1 Collection free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.