Case Management

Update a maintenance window

Updates the name, query, start time, or end time of an existing maintenance window.

put/api/v2/maintenance_windows/{maintenance_window_id}

Request

Base URL
https://api.datadoghq.com
URL
https://api.datadoghq.com/api/v2/maintenance_windows/{maintenance_window_id}
Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2
  Authorization code: /oauth2/v1/authorize
  Token URL: /oauth2/v1/token scopes: event_correlation_config_write

Path parameters

maintenance_window_idstring required

The UUID of the maintenance window.

Request body

Example request

{
  "data": {
    "type": "maintenance_window"
  }
}

Response

Example response

{
  "data": {
    "attributes": {
      "end_at": "2026-06-01T06:00:00Z",
      "name": "Weekly maintenance",
      "query": "project:SEC",
      "start_at": "2026-06-01T00:00:00Z"
    },
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "maintenance_window"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.