Report this

What is the reason for this report?

How do I get a list of valid arguments for API calls?

Posted on September 7, 2015

Many of the API arguments must exactly match some list of valid values, which is prone to change over time, and I can’t find a list of valid values. For example, if I want to create a new droplet, I need to create a request like this:

{
  "name": "example.com",
  "region": "nyc3",
  "size": "512mb",
  "image": "ubuntu-14-04-x64",
  "ssh_keys": null,
  "backups": false,
  "ipv6": true,
  "user_data": null,
  "private_networking": null
}

So for “image” I can see that “ubuntu-14-04-x64” is one of the valid slugs, but how can I find a list of the other valid possibilities?



This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

These answers are provided by our Community. If you find them useful, show some love by clicking the heart. If you run into issues leave a comment, or add your own answer to help others.

I figured it out. For each parameter (region, size, image, etc) you can query those parameters to get all. So for example, in .NET, do this:

var regions = client.Regions.GetAll ().Result;
var images = client.Images.GetAll ().Result;
var sizes = client.Sizes.GetAll ().Result;

The developer cloud

Scale up as you grow — whether you're running one virtual machine or ten thousand.

Get started for free

Sign up and get $200 in credit for your first 60 days with DigitalOcean.*

*This promotional offer applies to new accounts only.