v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB

DigitalOcean-public.v2-new_Databases

Configure a Database Cluster's Maintenance Window

To configure the window when automatic maintenance should be performed for a database cluster, send a PUT request to /v2/databases/$DATABASE_ID/maintenance. A successful request will receive a 204 No Content status code with no body in response.

put/v2/databases/{database_cluster_uuid}/maintenance

Path parameters

database_cluster_uuidstring uuid required

A unique identifier for a database cluster.

Request body

daystring required

The day of the week on which to apply maintenance updates.

hourstring required

The hour in UTC at which maintenance updates will be applied in 24 hour format.

pendingboolean

A boolean value indicating whether any maintenance is scheduled to be performed in the next window.

descriptionstring[]

A list of strings, each containing information about a pending maintenance update.

Example request

{
  "day": "tuesday",
  "hour": "14:00",
  "pending": true,
  "description": [
    "Update TimescaleDB to version 1.2.1",
    "Upgrade to PostgreSQL 11.2 and 10.7 bugfix releases"
  ]
}

Response

The action was successful and the response body is empty.