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_byandmonitor.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/jsonResponse 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/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}429: Too many requests
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | An array of downtimes. | |
| meta | No | ||
| included | No | Array of objects related to the downtimes. |