Maintenance windows API

This API is deprecated. Use the Maintenance windows configuration API instead.

Dynatrace uses maintenance windows to ensure accurate monitoring data during planned maintenance of your systems.

The Maintenance windows API enables you to use 3rd party tools to manage maintenance windows and downtimes within a monitored environment. You can:

GET all maintenance windows

Lists all maintenance windows (and their parameters) available in your Dynatrace environment.

The request produces an application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/maintenance
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/maintenance

Authentication

To execute this request, you need the Deprecated: Configure maintenance windows (MaintenanceWindows) permission assigned to your API token. To learn how to obtain and use it, see Authentication.

POST a maintenance window

Creates or updates a maintenance window.

The request consumes an application/json payload.

POST
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/maintenance
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/maintenance

Authentication

To execute this request, you need the Deprecated: Configure maintenance windows (MaintenanceWindows) permission assigned to your API token. To learn how to obtain and use it, see Authentication.

GET a maintenance window

Lists all parameters of a maintenance window. You can also get the list of all maintenance windows (and their parameters) available in your Dynatrace environment.

The request produces an application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/maintenance/{uid}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/maintenance/{uid}

Authentication

To execute this request, you need the Deprecated: Configure maintenance windows (MaintenanceWindows) permission assigned to your API token. To learn how to obtain and use it, see Authentication.

DELETE a maintenance window

Deletes the specified maintenance window. Deletion can't be undone.

DELETE
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/maintenance/{uid}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/maintenance/{uid}

Authentication

To execute this request, you need the Deprecated: Configure maintenance windows (MaintenanceWindows) permission assigned to your API token. To learn how to obtain and use it, see Authentication.