DigitalOcean Changelog

Tagging in Droplet create

Date: November 10, 2016

Tagged In: API v2

Author Michael Chittenden

You may now pass tags as an attribute when creating one or more new Droplets. This optional parameter will create and apply the specified tag(s) to the newly created Droplet(s). For more information see create Droplet documentation.

API v1 end-of-life

Date: November 9, 2015

Tagged In: API v1

Author Michael Chittenden

API v1 has reached end-of-life. All subsequent requests to API v1 will respond with HTTP 410 (Gone) and an error message:

# HTTP/1.1 410 (Gone)
  "status": "ERROR",
  "error_message": "API v1 has reached end-of-life. Please use API v2.",
  "message": "API v1 has reached end-of-life. Please use API v2."

Version 2 of our API provides a more RESTful interface, OAuth support, and allows access to new DigitalOcean features like Team Account Management and Floating IPs. To learn more, please visit the API documentation.

Sunsetting API v1

Date: May 1, 2015

Tagged In: API v1

Author Andrew Starr-Bochicchio

Since releasing version 2 of our API nearly a year ago and officially bringing it out of beta last month, we’ve seen a tremendous uptake of usage by our community. As the ecosystem of tools and libraries continues to grow, we’ve decided that it is time to sunset version 1 of the API.

Don’t worry! We’re not going to pull the rug out from under you. In order to give everyone time to port their tools, version 1 will not be turned off until Monday, November 9, 2015.

With its (more) RESTful interface and features like OAuth support, v2 is both powerful and easy to use. Our developer documentation should give you all the information you need to begin the transition. If you have questions, you can always ask on our Community site or on Twitter.

Sizes available

Date: March 4, 2015

Tagged In: API v2

Author Phillip Baker

Size objects now expose an available boolean attribute, which represents whether new Droplets can be created with the size.

Breaking changes in Action objects (March 20, 2015)

Date: February 20, 2015

Tagged In: API v2

Author Phillip Baker

All action objects, i.e. those returned by the /v2/actions, /v2/droplets/$ID/actions and /v2/images/$ID/actions endpoint now return a region_slug attribute, in addition to a region attribute. At 00:01 March 20, 2015 UTC, API v2 will start returning an embedded region object at the region attribute, not a slug.

For example, the API request:

curl -X GET -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer b7d03a6947b217efb6f3ec3bd3504582' \

would return:

  "actions": [
      "id": 36804636,
      "status": "completed",
      "type": "create",
      "started_at": "2014-11-14T16:29:21Z",
      "completed_at": "2014-11-14T16:30:06Z",
      "resource_id": 3164444,
      "resource_type": "droplet",
      "region": {
        "name": "New York 3",
        "slug": "nyc3",
        "sizes": [
        "features": [
        "available": true
      "region_slug": "nyc3"
  "links": {
    "pages": {
      "last": "",
      "next": ""
  "meta": {
    "total": 159

Increase Rate Limit

Date: February 8, 2015

Tagged In: API v2

Author Phillip Baker

The maximum allowed rate limit per O-Auth token has been increased to 5,000 requests/hour.

User Image filtering

Date: January 22, 2015

Tagged In: API v2

Author Robert Ross

The images now supports a private filter which will allow you to retrieve all images that are specific to your account (IE: backups and snapshots).

For more information, you can view the documentation for this endpoint here.

New Droplet create validations

Date: January 20, 2015

Tagged In: API v2

Author Phillip Baker

API V2 now validates SSH key IDs and identifiers passed into the Droplet create call. In addition, API V2 now validates that requested features are available for a Droplet (backups, private networking, IPv6 and user data).

Add Images Filtering

Date: November 6, 2014

Tagged In: API v2

Author Robert Ross

The API v2 now supports retrieving images by type, to retrieve an image by type, simply append:

GET /v2/images?type={distribution,application}

Change type to what you would like to retrieve and voilà!

DropletKit (The Ruby API Client) also supports this functionality as well in Version 1.1.0

You can view the documentation for this feature here.

Making Sizes Clearer

Date: October 27, 2014

Tagged In: API v2

Author Aaron Lee

The JSON object for a droplet no longer contains a nested Size object, but rather a slug called size_slug that references a Size object. Please see the droplet docs for the updated structure.

The Image JSON object now includes a min_disk_size attribute that contains the slug of the minimum size droplet required for that image. For example a snapshot of a 1 Gig droplet will have “1gb” as it’s min_disk_size.

Prices are now numbers!

Date: July 25, 2014

Tagged In: API v2

Author Brooke McKim

Both price_monthly and price_hourly were previously strings. This made them harder to work with so we have gone ahead and turned them into floats.

Per Page Tweaks

Date: July 2, 2014

Tagged In: API v2

Author Brooke McKim

We have tweaked the per_page limits to default to 20 and be a maximum of 200. We have found in our testing, so far, for this to be a good balance of requests versus results. Head on over and read up on pagination.

Removed X- from RateLimit Header

Date: June 24, 2014

Tagged In: API v2

Author Brooke McKim

It seems adding X- to custom HTTP headers is going out of style.

So we gone ahead and changed our RateLimit headers to no longer include the X.

They now look like this: