sckott
By:
sckott

Access to applications via the v2 API

October 1, 2014 1.3k views

There are applications such as Gitlab, Docker, etc that can be accessed and used while spinning up a droplet via the web interface. I don't see access to these applications via the API. Or did I miss it? If so, where is it documented? If not, coming any time soon? Or does it not make sense to include in the API?

Thanks! Scott Chamberlain

1 Answer

The application images are treated like any other image by the API. You can find them by querying the list of images. For instance, here's the result for the Docker image:

    {
      "id":6375976,
      "name":"Docker 1.2.0 on Ubuntu 14.04",
      "distribution":"Ubuntu",
      "slug":"docker",
      "public":true,
      "regions":[
        "nyc1",
        "ams1",
        "sfo1",
        "nyc2",
        "ams2",
        "sgp1",
        "lon1",
        "nyc3",
        "ams3"
      ],
      "created_at":"2014-09-26T19:48:01Z"
    }

Note, the docker slug. You can use this in place of the image ID when creating a droplet as it is guaranteed to be stable while the ID may change if the image is updated.

Remember that API results are paginated. Sometimes this trips people up as they don't realize the image they are looking for is on the next page.

  • You're right! It was the pagination. We're working on a client, and had a bug in pagination. Sorry about that :/

    Thanks! Scott

Have another answer? Share your knowledge.