create droplet from snapshot by REST api

December 30, 2014 4.4k views

Can't found in the documentation,
but that is not working ,
also tried to put "snapshot_id" in the "image"
no good.

  "image":"ubuntu-14-04-x64" , "snapshot_ids": ["java-8-snapshot"]}
4 Answers

Can you share the API call you actually made and the error message that was returned? It would help us figure out what's going on here.

To launch a new droplet based on a snapshot, you need to supply it's ID for the image parameter:

curl -X POST -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer $TOKEN' -d \
    '{"name":"","region":"nyc3","size":"512mb","image": 12345}' \

yeah I passed the authentication stage
the JSON I pasted is the command

nop, the droplet was created,
it just was an empty droplet
not a snapshot image.

  • You need to pass the image ID, not the snapshot name. To list all images with their IDs:

    curl -X GET -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN' ""

    Once you find the snapshot's id, pass it as follows:

    {"name":"","region":"ams2","size":"512mb","ssh_keys":null,"backups":false,"ipv6":true,"user_data":"Peer1","private_networking":null, "image":"ID HERE"}
  • Thanks, sound like a good direction:
    I did that and got an empty list
    even that I clearly see on the web
    one snapshot, created by me yesterday.

  • [SOLVED] this is a GET request so now I do have
    the image.

    "droplet": {
        "id": 3622537,
        "name": "",
        "memory": 512,
        "vcpus": 1,
        "disk": 20,
        "locked": true,
        "status": "new",
        "kernel": {
            "id": 2233,
            "name": "Ubuntu 14.04 x64 vmlinuz-3.13.0-37-generic",
            "version": "3.13.0-37-generic"
        "created_at": "2014-12-30T21:43:03Z",
        "features": [
        "backup_ids": [],
        "snapshot_ids": [],
        "image": {},
        "size_slug": "512mb",
        "networks": {},
        "region": {}
    "links": {
        "actions": [
                "id": 40095737,
                "rel": "create",
                "href": ""
Have another answer? Share your knowledge.