Datadog

Datadog Create API

The Create API from Datadog — 69 operation(s) for create.

GitHub OpenAPI

Operations 51

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/v2/api_keys Create a new API key · Datadog Create an Api Key #
Ask an LLM
“Can I generate a fresh Datadog API key for a new agent or service?”
“What do I need to send to mint an API key for my organization?”
Tell an agent
Create an API key named {key_name}.
Generate a new API key for {key_name} so our collector can submit data.
POST /api/v2/apicatalog/openapi Register an API in the API Catalog from OpenAPI · Datadog Create a New Api #
Ask an LLM
“Can I add an API to the API Catalog by uploading its OpenAPI file?”
“What comes back when I import an OpenAPI spec into the API Catalog?”
Tell an agent
Import {openapi_spec_file} into the API Catalog as a new API.
Register a new catalog API from the OpenAPI spec file {openapi_spec_file} and give me its ID.
POST /api/v2/apm/config/metrics Create a metric from ingested spans · Datadog Create a Span-based Metric #
Ask an LLM
“Can I turn my APM spans into a custom metric?”
“How do I generate a span-based metric from traces I'm already ingesting?”
Tell an agent
Create a span-based metric defined as {metric}.
Build a metric from ingested spans using {metric} as its definition.
POST /api/v2/apm/config/retention-filters Create an APM span retention filter · Datadog Create a Retention Filter #
Ask an LLM
“Can I choose which spans get indexed and retained in APM?”
“Is there a way to add a retention filter so certain traces are kept?”
Tell an agent
Create an APM retention filter {filter} to index matching spans.
Add a span retention filter with definition {filter}.
POST /api/v2/authn_mappings Map an identity provider attribute to a role · Datadog Create an Authn Mapping #
Ask an LLM
“Can I map a SAML attribute from my identity provider to a Datadog role?”
“What does an AuthN mapping need to grant roles on login?”
Tell an agent
Create an AuthN mapping {mapping} that assigns a role from an IdP attribute.
Add an authentication mapping using {mapping}.
POST /api/v2/cases/projects Create a Case Management project · Datadog Create a Project #
Ask an LLM
“Can I set up a new project to organize cases in Case Management?”
“What's required to add a case project?”
Tell an agent
Create a case project called {project}.
Set up a new Case Management project with {project}.
POST /api/v2/catalog/entity Create or update Software Catalog entities · Datadog Create or Update Entities #
Ask an LLM
“Can I register services and other entities in the Software Catalog programmatically?”
“Will posting an entity definition overwrite an existing catalog entity with the same name?”
Tell an agent
Upsert my Software Catalog entity definitions.
Register or refresh our entities in the Software Catalog.
POST /api/v2/cloud_security_management/custom_frameworks Create a custom compliance framework · Datadog Create a Custom Framework #
Ask an LLM
“Can I define my own compliance framework in Cloud Security Management?”
“What goes into a custom framework when I create one?”
Tell an agent
Create a custom compliance framework from {framework}.
Add a new custom framework with handle and version given in {framework}.
POST /api/v2/incidents Declare a new incident · Datadog Create an Incident #
Ask an LLM
“How do I open a new incident from a script or alert handler?”
“What fields does a new incident need when I declare it?”
Tell an agent
Declare an incident titled {incident}.
Open a new incident with details {incident}.
POST /api/v2/incidents/config/types Create an incident type · Datadog Create an Incident Type #
Ask an LLM
“Can I add a new incident type, like security vs. operational?”
“Which settings are needed to define a custom incident type?”
Tell an agent
Create an incident type named {incident_type}.
Add a new incident type defined as {incident_type}.
POST /api/v2/incidents/{incident_id}/relationships/integrations Attach integration metadata to an incident · Datadog Create an Incident Integration Metadata #
Ask an LLM
“Can I record which external tool or channel is tied to an incident?”
“Where do I store integration metadata for a specific incident?”
Tell an agent
Attach integration metadata {integration} to incident {incident_id}.
Add an integration record to incident {incident_id}.
POST /api/v2/incidents/{incident_id}/relationships/todos Add a to-do to an incident · Datadog Create an Incident Todo #
Ask an LLM
“Can I add follow-up tasks to an incident?”
“Is it possible to assign a to-do item on an active incident?”
Tell an agent
Add the to-do {todo} to incident {incident_id}.
Create a task on incident {incident_id} for the responders.
POST /api/v2/integration/aws/accounts Connect an AWS account integration · Datadog Create an Aws Integration #
Ask an LLM
“How do I connect a new AWS account to Datadog?”
“What config does an AWS account integration need?”
Tell an agent
Create an AWS account integration with config {aws_account}.
Connect AWS account {aws_account} to monitoring.
POST /api/v2/integration/gcp/sts_delegate Create the Datadog GCP principal · Datadog Create a Datadog Gcp Principal #
Ask an LLM
“Can I create the Datadog service principal needed for GCP STS delegation?”
“What principal should I grant in Google Cloud for the Datadog integration?”
Tell an agent
Create the Datadog GCP STS delegate principal.
Make a Datadog principal for our GCP integration.
POST /api/v2/integration/ms-teams/configuration/tenant-based-handles Add a Microsoft Teams tenant-based handle · Datadog Create Tenant-based Handle #
Ask an LLM
“Can I add a handle so alerts post to a specific Microsoft Teams channel?”
“What does a tenant-based handle in the Teams integration need?”
Tell an agent
Create a Microsoft Teams tenant-based handle {handle}.
Add a tenant-based Teams handle pointing at {handle}.
POST /api/v2/integration/ms-teams/configuration/workflows-webhook-handles Add a Microsoft Teams Workflows webhook handle · Datadog Create Workflows Webhook Handle #
Ask an LLM
“Can I send notifications to Teams through a Workflows webhook instead of a tenant?”
“What's needed to register a Teams Workflows webhook handle?”
Tell an agent
Create a Teams Workflows webhook handle {handle}.
Register the Workflows webhook URL in {handle} as a Teams handle.
POST /api/v2/integration/opsgenie/services Add an Opsgenie service object · Datadog Create a New Service Object #
Ask an LLM
“Can I add a new Opsgenie service to the integration?”
“What do I need to create an Opsgenie service object?”
Tell an agent
Create an Opsgenie service {service}.
Add a new service to the Opsgenie integration using {service}.
POST /api/v2/logs/config/custom-destinations Create a custom log forwarding destination · Datadog Create a Custom Destination #
Ask an LLM
“Can I forward logs to my own destination outside the platform?”
“What does a custom log destination definition include?”
Tell an agent
Create a custom log destination {destination}.
Set up log forwarding to a new custom destination.
POST /api/v2/logs/config/metrics Create a metric from ingested logs · Datadog Create a Log-based Metric #
Ask an LLM
“Can I generate a metric from log events I'm ingesting?”
“How do I count matching log lines as a custom metric?”
Tell an agent
Create a log-based metric {metric}.
Generate a metric from ingested logs defined by {metric}.
POST /api/v2/logs/config/restriction_queries Create a log restriction query · Datadog Create a Restriction Query #
Ask an LLM
“Can I restrict which logs certain roles are allowed to see?”
“What's a restriction query and how do I add one?”
Tell an agent
Create a log restriction query {restriction_query}.
Add a new restriction query to limit log access.
POST /api/v2/monitor/notification_rule Create a monitor notification rule · Datadog Create a Monitor Notification Rule #
Ask an LLM
“Can I route monitor alerts to recipients with a rule instead of per monitor?”
“What does a monitor notification rule need?”
Tell an agent
Create a monitor notification rule {rule}.
Add a notification rule for monitors defined as {rule}.
POST /api/v2/on-call/escalation-policies Create an On-Call escalation policy · Datadog Create On-call Escalation Policy #
Ask an LLM
“Can I set up an escalation policy that pages the next tier if nobody responds?”
“Which relationships can be included in the response when creating an escalation policy?”
Tell an agent
Create an escalation policy {policy}.
Create escalation policy {policy} and include {include} in the response.
POST /api/v2/on-call/pages Trigger an On-Call page · Datadog Create On-call Page #
Ask an LLM
“Can I page whoever is on call from a script?”
“What do I send to trigger a new On-Call page?”
Tell an agent
Page the on-call responder with {page}.
Trigger an On-Call page now.
POST /api/v2/on-call/schedules Create an On-Call schedule · Datadog Create On-call Schedule #
Ask an LLM
“Can I build a rotation schedule for on-call coverage?”
“What layers and members does a new on-call schedule need?”
Tell an agent
Create an on-call schedule {schedule}.
Create on-call schedule {schedule} including {include} in the result.
POST /api/v2/powerpacks Create a dashboard powerpack · Datadog Create a New Powerpack #
Ask an LLM
“Can I package a group of dashboard widgets as a reusable powerpack?”
“What goes into a powerpack when I create it?”
Tell an agent
Create a powerpack {powerpack}.
Save a new reusable widget powerpack.
POST /api/v2/remote_config/products/asm/waf/custom_rules Create a WAF custom rule · Datadog Create a Waf Custom Rule #
Ask an LLM
“Can I write my own WAF rule to block a specific request pattern?”
“What parameters does a WAF custom rule take?”
Tell an agent
Create a WAF custom rule {rule}.
Add a custom Application Security WAF rule defined as {rule}.
POST /api/v2/remote_config/products/asm/waf/exclusion_filters Create a WAF exclusion filter · Datadog Create a Waf Exclusion Filter #
Ask an LLM
“Can I stop the WAF from flagging requests from a trusted scanner?”
“What happens to a request that matches a WAF exclusion filter?”
Tell an agent
Create a WAF exclusion filter {filter}.
Passlist requests matching {filter} from the Application Security WAF.
POST /api/v2/remote_config/products/cws/policy Create a Workload Protection policy · Datadog Create a Workload Protection Policy #
Ask an LLM
“Can I create a Workload Protection agent policy?”
“Is the Workload Protection policy endpoint available on the US1-FED site?”
Tell an agent
Create a Workload Protection policy {policy}.
Add a new Workload Protection agent policy with {policy}.
POST /api/v2/remote_config/products/obs_pipelines/pipelines Create an Observability Pipeline · Datadog Create a New Pipeline #
Ask an LLM
“Can I create an Observability Pipelines configuration through the API?”
“What configuration does a new observability pipeline need?”
Tell an agent
Create an observability pipeline with config {pipeline}.
Set up a new Observability Pipelines pipeline from {pipeline}.
POST /api/v2/roles Create a role · Datadog Create Role #
Ask an LLM
“Can I create a custom role for my organization?”
“What do I provide when making a brand-new role?”
Tell an agent
Create a role named {role}.
Add a new organization role defined as {role}.
POST /api/v2/roles/{role_id}/clone Clone an existing role · Datadog Create a New Role by Cloning an Existing Role #
Ask an LLM
“Can I copy an existing role's permissions into a new role?”
“Is there a way to duplicate a role under a new name?”
Tell an agent
Clone role {role_id} as {new_role}.
Duplicate role {role_id} into a new role.
POST /api/v2/rum/applications/{app_id}/retention_filters Create a RUM retention filter · Datadog Create a Rum Retention Filter #
Ask an LLM
“Can I choose which RUM sessions are retained for one application?”
“What does a RUM retention filter for an app need?”
Tell an agent
Create a RUM retention filter {filter} for application {app_id}.
Add a retention filter to RUM app {app_id}.
POST /api/v2/rum/config/metrics Create a metric from RUM data · Datadog Create a Rum-based Metric #
Ask an LLM
“Can I generate a metric from Real User Monitoring events?”
“What's needed to define a RUM-based metric?”
Tell an agent
Create a RUM-based metric {metric}.
Generate a metric from RUM events defined by {metric}.
POST /api/v2/scim/Groups Create a SCIM group · Datadog Create Group #
Ask an LLM
“Can I provision a group through SCIM with its members already in it?”
“Is an id required when creating a SCIM group?”
Tell an agent
Create a SCIM group named {display_name}.
Provision SCIM group {display_name} with members {members}.
POST /api/v2/scim/Users Provision a user through SCIM · Datadog Create User #
Ask an LLM
“Can my identity provider provision users through SCIM?”
“Which user fields can I set when provisioning through SCIM?”
Tell an agent
Provision SCIM user {user_name} with email {emails}.
Create a SCIM user {user_name} titled {title}.
POST /api/v2/scorecard/rules Create a scorecard rule · Datadog Create a New Rule #
Ask an LLM
“Can I add my own rule to service scorecards?”
“What does a new scorecard rule definition contain?”
Tell an agent
Create a scorecard rule {rule}.
Add a new service scorecard rule.
POST /api/v2/security/signals/notification_rules Create a security signal notification rule · Datadog Create a New Signal-based Notification Rule #
Ask an LLM
“Can I get notified when certain security signals fire?”
“What does a signal-based notification rule return once created?”
Tell an agent
Create a security signal notification rule {rule}.
Notify my team about security signals using rule {rule}.
POST /api/v2/security/vulnerabilities/notification_rules Create a vulnerability notification rule · Datadog Create a New Vulnerability-based Notification Rule #
Ask an LLM
“Can I be alerted when new vulnerabilities are detected?”
“What does a vulnerability-based notification rule include?”
Tell an agent
Create a vulnerability notification rule {rule}.
Alert my team about vulnerabilities with notification rule {rule}.
POST /api/v2/security_monitoring/configuration/security_filters Create a security filter · Datadog Create a Security Filter #
Ask an LLM
“Can I exclude some logs from security analysis with a filter?”
“Where is the guidance for setting up security filters?”
Tell an agent
Create a security filter {filter}.
Add a Cloud SIEM security filter defined as {filter}.
POST /api/v2/security_monitoring/configuration/suppressions Create a security signal suppression rule · Datadog Create a Suppression Rule #
Ask an LLM
“Can I suppress noisy security signals for known activity?”
“What does a suppression rule need?”
Tell an agent
Create a suppression rule {suppression}.
Suppress signals matching {suppression}.
POST /api/v2/security_monitoring/rules Create a detection rule · Datadog Create a Detection Rule #
Ask an LLM
“How do I add a new threat detection rule?”
“Can I write a custom detection rule for security monitoring?”
Tell an agent
Create a security detection rule.
Add a new detection rule to Security Monitoring.
POST /api/v2/sensitive-data-scanner/config/groups Create a Sensitive Data Scanner group · Datadog Create Scanning Group #
Ask an LLM
“Can I create a scanning group to look for sensitive data in logs?”
“Can rules be created at the same time as a scanning group?”
Tell an agent
Create a sensitive data scanning group {group}.
Add a new Sensitive Data Scanner group.
POST /api/v2/sensitive-data-scanner/config/rules Create a Sensitive Data Scanner rule · Datadog Create Scanning Rule #
Ask an LLM
“Can I add a regex rule to a sensitive data scanning group?”
“Must a scanning rule use either a standard pattern or a regex, not both?”
Tell an agent
Create a scanning rule {rule} with meta {meta}.
Add scanning rule {rule} to the end of its group, using meta {meta}.
POST /api/v2/services Create an incident service · Datadog Create a New Incident Service #
Ask an LLM
“Can I add a service that incidents can be attributed to?”
“What's needed to create an incident service?”
Tell an agent
Create an incident service named {service}.
Add {service} as a new incident service.
POST /api/v2/services/definitions Create or update Service Catalog definitions · Datadog Create or Update Service Definition #
Ask an LLM
“Can I push service definitions into the Service Catalog?”
“Does posting a service definition update one that already exists?”
Tell an agent
Create or update my Service Catalog service definitions.
Push the latest service definition to the Service Catalog.
POST /api/v2/slo/report Start an SLO report job · Datadog Create a New Slo Report #
Ask an LLM
“Can I export an SLO report as a CSV?”
“Is SLO report generation synchronous or do I have to poll for it?”
Tell an agent
Start an SLO report job for {report}.
Generate a CSV SLO report with parameters {report}.
POST /api/v2/team Create a team · Datadog Create a Team #
Ask an LLM
“Can I create a team and add users to it in one request?”
“What's required to create a new team?”
Tell an agent
Create a team called {team}.
Set up a new team {team} with its initial members.
POST /api/v2/teams Create an incident team · Datadog Create a New Incident Team #
Ask an LLM
“Can I create a team that responds to incidents?”
“What does an incident team need when created?”
Tell an agent
Create an incident team named {incident_team}.
Add {incident_team} as a new incident response team.
POST /api/v2/users Create a user · Datadog Create a User #
Ask an LLM
“Can I add a user to my organization without SCIM?”
“What details are needed to create a user account?”
Tell an agent
Create a user with {user}.
Add {user} as a new user in my organization.
POST /api/v2/workflows Create a workflow automation · Datadog Create a Workflow #
Ask an LLM
“Can I create a Workflow Automation workflow from code?”
“Which permission does my application key need to create workflows?”
Tell an agent
Create a workflow defined as {workflow}.
Build a new automation workflow from {workflow} and return its ID.

Documentation

📖
Documentation
https://docs.datadoghq.com/api/latest/
📖
Authentication
https://docs.datadoghq.com/api/latest/authentication/
📖
Documentation
https://docs.datadoghq.com/api/latest/metrics/
📖
Documentation
https://docs.datadoghq.com/api/latest/logs/
📖
Documentation
https://docs.datadoghq.com/api/latest/events/
📖
Documentation
https://docs.datadoghq.com/api/latest/monitors/
📖
Documentation
https://docs.datadoghq.com/api/latest/incidents/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/openapi/datadog-create-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-metric-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-log-event-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-event-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-monitor-schema.json

Other Resources

🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/graphql/datadog-graphql.md
🔗
Reference
https://docs.datadoghq.com/metrics/
🔗
Reference
https://docs.datadoghq.com/logs/
🔗
Reference
https://docs.datadoghq.com/service_management/events/
🔗
Reference
https://docs.datadoghq.com/monitors/
🔗
Reference
https://docs.datadoghq.com/service_management/incident_management/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/datadog:datadog-create-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

datadog-create-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: support@datadoghq.com
    name: Datadog Support
    url: https://www.datadoghq.com/support/
  description: 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.
  title: Datadog Create API
  version: '1.0'
servers:
- url: https://{subdomain}.{site}
  variables:
    site:
      default: datadoghq.com
      description: The regional site for Datadog customers.
      enum:
      - datadoghq.com
      - us3.datadoghq.com
      - us5.datadoghq.com
      - ap1.datadoghq.com
      - datadoghq.eu
      - ddog-gov.com
    subdomain:
      default: api
      description: The subdomain where the API is deployed.
- url: '{protocol}://{name}'
  variables:
    name:
      default: api.datadoghq.com
      description: Full site DNS name.
    protocol:
      default: https
      description: The protocol for accessing the API.
- url: https://{subdomain}.{site}
  variables:
    site:
      default: datadoghq.com
      description: Any Datadog deployment.
    subdomain:
      default: api
      description: The subdomain where the API is deployed.
security:
- apiKeyAuth: []
  appKeyAuth: []
tags:


# --- truncated at 32 KB (650 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/openapi/datadog-create-api-openapi.yml