API Reference

The Datadog API is an HTTP REST API. The API uses resource-oriented URLs to call the API, uses status codes to indicate the success or failure of requests, returns JSON from all requests, and uses standard HTTP response codes. Use the Datadog API to access the Datadog platform programmatically.

Getting started

Authenticate to the API with an API key using the header DD-API-KEY. For some endpoints, you also need an Application key, which uses the header DD-APPLICATION-KEY.

To try out the API Run in Postman

Note: To authenticate to the Datadog API through Postman, add your Datadog API and Application key values to the Collection variables of the Datadog API collection.

Using the API is a guide to the endpoints.

Notes:

  • Add your API and application key values to the Variables tab of the Datadog API Collection.
  • cURL code examples assume usage of BASH and GNU coreutils. On macOS, you can install coreutils with the Homebrew package manager: brew install coreutils

Client libraries

By default, the Datadog API Docs show examples in cURL. Select one of our official client libraries languages in each endpoint to see code examples from that library. To install each library:

Installation

pip3 install datadog-api-client

Usage

import datadog_api_client

Or check out the libraries directly:

Java
Python
Ruby
Go
Typescript
Rust

Trying to get started with the application instead? Check out Datadog’s general Getting Started docs.

Further reading

PREVIEWING: aaron.hoffman/SDCD-952_write-rollback-cd-docs