Skip to main content
Datadog logo

​
Overview

Add Datadog to any ModuleX agent or workflow. Infrastructure monitoring, log management, and application performance platform via the Datadog REST API (api.{region}/api).
Categories: Monitoring & Observability · Developer Tools & Infrastructure · Auth: Datadog API Keys · Actions: 11

​
Authentication

​
Datadog API Keys

Authenticate using your Datadog API key and Application key
1

Step 1

Go to https://app.datadoghq.com/organization-settings/api-keys and sign in
2

Step 2

Copy or create a new API key
3

Step 3

Go to https://app.datadoghq.com/organization-settings/application-keys
4

Step 4

Copy or create a new Application key
5

Step 5

Paste both keys below

​
Required Credentials

FieldDescriptionRequiredFormat
API KeyYour Datadog API key from Organization Settings > API KeysYesxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Application KeyYour Datadog Application key from Organization Settings > Application KeysYesxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Available Actions

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Region"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Label"
    },
    "api_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Url"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetAccountInfoOutput",
  "type": "object"
}

​
Parameters

​
region
string
required
The regional site for the Datadog account (e.g. datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ddog-gov.com)
​
metric
string
required
The name of the timeseries metric
​
points
object
required
Points as a JSON object where keys are Unix timestamps (seconds) and values are numeric (e.g. {“1640995200”: 1.0})

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "errors": {
      "items": {
        "type": "string"
      },
      "title": "Errors",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "PostMetricDataOutput",
  "type": "object"
}

​
Parameters

​
region
string
required
The regional site for the Datadog account (e.g. datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ddog-gov.com)
​
filter_shared
boolean
If true, only return dashboards that are shared
​
count
integer
Maximum number of dashboards to return
​
start
integer
Offset for pagination

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "dashboards": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Dashboards",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchDashboardsOutput",
  "type": "object"
}

​
Parameters

​
region
string
required
The regional site for the Datadog account (e.g. datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ddog-gov.com)
​
start
integer
POSIX timestamp (seconds) for the start of the query window; defaults to 24 hours ago
​
end
integer
POSIX timestamp (seconds) for the end of the query window; defaults to now
​
priority
string
Filter by event priority: normal or low
​
sources
string
Comma-separated list of sources to filter events (e.g. nagios,hudson)
​
tags
string
Comma-separated list of tags to filter events (e.g. env:prod,role:db)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "events": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Events",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchEventsOutput",
  "type": "object"
}

​
Parameters

​
region
string
required
The regional site for the Datadog account (e.g. datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ddog-gov.com)
​
filter
string
Filter hosts by name, alias, or tag (e.g. env:production or host:web-01)
​
sort_field
string
Field to sort hosts by: status, apps, cpu, iowait, or load
​
sort_dir
string
Direction of sort: asc or desc
​
count
integer
Number of hosts to return (max 1000)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "host_list": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Host List",
      "type": "array"
    },
    "total_matching": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total Matching"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchHostsOutput",
  "type": "object"
}

​
Parameters

​
region
string
required
The regional site for the Datadog account (e.g. datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ddog-gov.com)
​
query
string
Search query to filter incidents using field:value syntax (e.g. state:active or severity:SEV-1)
​
page_size
integer
Number of incidents per page (default 10)
​
page_offset
integer
Offset for pagination

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "incidents": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Incidents",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchIncidentsOutput",
  "type": "object"
}

​
Parameters

​
region
string
required
The regional site for the Datadog account (e.g. datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ddog-gov.com)
​
query
string
required
Search query following log search syntax (e.g. service:web-app status:error) (Default: *)
​
from_time
string
Minimum timestamp for logs; supports date math (now-15m), ISO-8601, or epoch ms; defaults to 15 minutes ago
​
to_time
string
Maximum timestamp for logs; supports date math (now), ISO-8601, or epoch ms; defaults to now
​
indexes
array
List of log index names to search (defaults to all indexes); element type: string
​
limit
integer
Maximum number of logs to return per page (default 10, max 1000)
​
sort
string
Sort order for results: -timestamp (newest first) or timestamp (oldest first)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "logs": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Logs",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchLogsOutput",
  "type": "object"
}

​
Parameters

​
region
string
required
The regional site for the Datadog account (e.g. datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ddog-gov.com)
​
host
string
Filter metrics by host name

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "metrics": {
      "items": {
        "type": "string"
      },
      "title": "Metrics",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchMetricsOutput",
  "type": "object"
}

​
Parameters

​
region
string
required
The regional site for the Datadog account (e.g. datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ddog-gov.com)
​
query
string
Filter monitors by name, tag, or other attributes (e.g. tag:env:production or type:metric)
​
tags
string
Comma-separated list of tags to filter monitors (e.g. env:prod,team:backend)
​
page
integer
Page number to return (0-indexed)
​
page_size
integer
Number of monitors per page (default 100)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "monitors": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Monitors",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchMonitorsOutput",
  "type": "object"
}

​
Parameters

​
region
string
required
The regional site for the Datadog account (e.g. datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ddog-gov.com)
​
page_size
integer
Number of services per page (default 10)
​
page_number
integer
Page number (0-indexed)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "services": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Services",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchServicesOutput",
  "type": "object"
}

​
Limits & Quotas

  • Rate limits: Datadog enforces per-endpoint rate limits; default is 300 requests/minute for most endpoints, 60/min for logs search, and 120/hour for metric submission.
  • Pagination: Most list endpoints support pagination via count/start or page/page_size parameters.
  • Regions: The API base URL varies by account region. Use get_account_info to auto-detect the correct region before calling other tools.
  • Error model: Non-2xx responses and timeouts are caught and returned as success=False + error rather than raising.

PagerDuty

Sentry

Algolia