ListDowntimes

Retrieve active scheduled downtimes for Datadog monitoring. Filter by current status, include related resources, and manage pagination for focused downtime insights.

Instructions

Get all scheduled downtimes.

Query Parameters:

current_only: Only return downtimes that are active when the request is made.
include: Comma-separated list of resource paths for related resources to include in the response. Supported resource paths are created_by and monitor.
page[offset]: Specific offset to use as the beginning of the returned page.
page[limit]: Maximum number of downtimes in the response.

Responses:

200 (Success): OK
- Content-Type: application/json
- Response Properties:
  - data: An array of downtimes.
  - included: Array of objects related to the downtimes.
- Example:

{
  "data": [
    "unknown_type"
  ],
  "included": [
    "unknown_type"
  ],
  "meta": "unknown_type"
}

403: Forbidden
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

429: Too many requests
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

Input Schema

Name	Required	Description
`current_only`	No	Only return downtimes that are active when the request is made.
`include`	No	Comma-separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `monitor`.
`page[limit]`	No	Maximum number of downtimes in the response.
`page[offset]`	No	Specific offset to use as the beginning of the returned page.

Input Schema (JSON Schema)

{
  "properties": {
    "current_only": {
      "description": "Only return downtimes that are active when the request is made.",
      "type": "boolean"
    },
    "include": {
      "description": "Comma-separated list of resource paths for related resources to include in the response. Supported resource\npaths are `created_by` and `monitor`.",
      "example": "created_by,monitor",
      "type": "string"
    },
    "page[limit]": {
      "default": 30,
      "description": "Maximum number of downtimes in the response.",
      "format": "int64",
      "type": "integer"
    },
    "page[offset]": {
      "default": 0,
      "description": "Specific offset to use as the beginning of the returned page.",
      "example": 0,
      "format": "int64",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Datadog MCP Server

ListDowntimes

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Datadog MCP Server

Related Tools

MCP directory API