How can I perform Add to Region and Restore Droplet actions on a backup or snapshot?

The GUI offers “Add to Region” and “Restore Droplet” for a snapshot. How can I perform those actions on a backup or snapshot through the API?


Submit an 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.

Accepted Answer

After you take a snapshot of a Droplet, you can find the ID of that snapshot via the API by querying the /v2/images?private=true endpoint.

curl -X GET -H "Content-Type: application/json" \
   -H "Authorization: Bearer $DO_TOKEN" \

You can also use doctl, the DigitalOcean command line client, to acomplish this:

doctl compute image list-user

Once you have found the ID of your snapshot, you can make a POST to the /v2/droplets/$DROPLET_ID/actions endpoint to restore the snapshot to an existing Droplet:

curl -X POST -H "Content-Type: application/json" \
    -H "Authorization: Bearer $DO_TOKEN" \
    -d '{"type":"restore", "image": $SNAPSHOT_ID }' \

Or with doctl:

doctl compute droplet-action restore $DROPLET_ID --image-id $SNAPSHOT_ID

You can also add snapshots to additional regions with the API:

curl -X POST -H "Content-Type: application/json" \
    -H "Authorization: Bearer $DO_TOKEN" \
    -d '{"type":"transfer","region":"nyc2"}' \

And with doctl:

doctl compute image-action transfer $SNAPSHOT_ID --region nyc2