Skip to main content
POST
Rebuild instance

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234_abcdef

Path Parameters

project_id
integer
required

Project ID

Example:

1

region_id
integer
required

Region ID

Example:

1

instance_id
string<uuid4>
required

Instance ID

Example:

"a314d566-2772-4124-a4c4-5688ab76b928"

Body

application/json
image_id
string<uuid4>

Image ID. If you omit it, the instance keeps the current image.

Example:

"f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1"

ssh_key_name
string | null

Specifies the name of the SSH keypair, created via the /v1/ssh_keys endpoint. Use null to remove the SSH key from the instance. If you omit it, the instance keeps the current SSH key.

Example:

"my-ssh-key"

user_data
string

String in base64 format. Examples of the user_data: https://cloudinit.readthedocs.io/en/latest/topics/examples.html. If you omit it, the instance keeps the current user data.

Response

OK

tasks
string[]
required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

  • GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.
Example: