v8

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

DigitalOcean-public.v2-new_Droplets

Retrieve the Backup Policy for an Existing Droplet

To show information about an individual Droplet's backup policy, send a GET request to /v2/droplets/$DROPLET_ID/backups/policy.

get/v2/droplets/{droplet_id}/backups/policy

Path parameters

droplet_idinteger required

A unique identifier for a Droplet instance.

Response

The response will be a JSON object with a key called policy. This will be set to a JSON object that contains the standard Droplet backup policy attributes.

Example response

{
  "policy": {
    "droplet_id": 7101383,
    "backup_enabled": true,
    "backup_policy": {
      "plan": "daily",
      "weekday": "SUN",
      "window_length_hours": 4,
      "retention_period_days": 7
    },
    "next_backup_window": {
      "start": "2019-12-04T00:00:00Z",
      "end": "2019-12-04T23:00:00Z"
    }
  }
}