API v2 Changelog

< Back to Changelog

Changes to the Droplet Neighbors Report

Date: December 2, 2019

Tagged In: API v2

Author Andrew Starr-Bochicchio

The DigitalOcean API currently offers the ability to retrieve a report of all Droplets co-located on the same physical hardware by sending a GET request to the /v2/reports/droplet_neighbors endpoint. This endpoint has been deprecated and will begin responding with an HTTP status of 410 (Gone) on December 17th, 2019.

Today, in its place, a new endpoint is now available: /v2/reports/droplet_neighbors_ids. Rather than listing the full Droplet object, responses from this endpoint only contain sets of Droplet IDs co-located on the same physical hardware. For example:

{
  "neighbor_ids": [
    [168671828,168663509,168671815],
    [168671883,168671750]
  ]
}

This implementation is more performant and better able to scale for users with many Droplets. For all the information, find the full API reference documentation here.

The API also continues to offer the ability to list “neighbors” for a specific Droplet by sending a GET request to /v2/droplets/$DROPLET_ID/neighbors. This endpoint will continue to function without change.

We apologize for the inconvenience. If you need guidance on this transition, please feel free to reach out to the team by opening a support ticket.