DigitalOcean API Overview

The DigitalOcean API lets you programmatically manage your Droplets and other resources using conventional HTTP requests. Any action that you can perform through the DigitalOcean Control Panel (except for creating personal access tokens) can also be performed with the API.

Getting Started

Get familiar with the structure and behavior of the DigitalOcean API.
See examples of how to format requests to interact with the DigitalOcean API.
Create a personal access token for use with the DigitalOcean API.

API Reference Documentation

Programmatically manage Droplets and other DigitalOcean resources using conventional HTTP requests. All of the functionality in the DigitalOcean Control Panel is also available through the API.
Programmatically manage your data with Spaces’ AWS S3-compatible object storage API
The metadata API allows a Droplet to access information about itself including user data, Droplet ID, datacenter region, and IP addresses.
The OAuth API is a secure method for authenticating users and allowing third-party applications limited access to your servers or DigitalOcean user accounts.

API Clients

The official DigitalOcean API client for Go.
The official DigitalOcean API client for Ruby.
Official and community-created client libraries that let you use the DigitalOcean API in a variety of programming languages.

More Information

Keep up to date with changes to our APIs using the API filter in our release notes section.

You can also subscribe to the release notes RSS feed.

Latest Updates

24 August 2023

  • The 429 error response to reaching our API’s burst rate limit now includes a Retry-After header to indicate how long to wait (in seconds) before retrying a request. This additional header enables the configuration of automatic retries and exponentional backoffs in DigitalOcean clients such as doctl, Terraform, and Godo. Learn more about our API burst limit structure in our API Documentation.

18 August 2023

  • Released v1.98.0 of doctl, the official DigitalOcean CLI. This release adds support for automatically retrying API requests that fail with a 429 or 500-level error. The number of attempts can be configured using the --http-retry-max flag or DIGITALOCEAN_HTTP_RETRY_MAX environment variable. To disable retries altogether, set to 0.

20 July 2023

  • The Ubuntu 22.10 distribution has reached end of life and is deprecated as of 20 July 2023:

    The image will be removed from the control panel starting on 20 July 2023 but will remain accessible for Droplet creation via the API for 30 days after the initial deprecation. If you need to use Ubuntu 22.10 after the image has been fully deprecated, you can create Droplets from a snapshot of a Droplet with that version or from a custom image.

For more information, see the full release notes.