Rebuild a Server from an Image

POST

/servers/{id}/actions/rebuild

Rebuilds a Server overwriting its disk with the content of an Image, thereby destroying all data on the target Server

The Image can either be one you have created earlier (backup or snapshot Image) or it can be a completely fresh system Image provided by us. You can get a list of all available Images with GET /images.

Your Server will automatically be powered off before the rebuild command executes.

Request

Path Params

Body Params application/json

Examples

Responses

🟢201The `action` key in the reply contains an Action object with this structure

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.hetzner.cloud/v1/servers//actions/rebuild' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image": "ubuntu-20.04"
}'

Response Example

{
    "action": {
        "command": "rebuild_server",
        "error": {
            "code": "action_failed",
            "message": "Action failed"
        },
        "finished": null,
        "id": 13,
        "progress": 0,
        "resources": [
            {
                "id": 42,
                "type": "server"
            }
        ],
        "started": "2016-01-30T23:50:00.000Z",
        "status": "running"
    },
    "root_password": null
}

Modified at 2023-08-16 03:09:21

Soft-reboot a Server

Remove from Placement Group