Skip to main content
PUT
Update hardware settings

Authorizations

Authorization
string
header
required

Your API key, sent as a bearer token. Create one in the control panel under API Keys, give it only the permissions the integration needs, and copy it when it is created. It cannot be shown again. Each key is restricted to one owned team. The key determines the team for every request.

Path Parameters

server
string
required

The server UUID

Example:

"ecc6f4f1"

Body

multipart/form-data

Send a JSON object containing the fields below. Required fields are marked in the schema.

bios_type
enum<string>

The value of bios_type.

Available options:
ovmf,
seabios
sev_snp_enabled
boolean

Whether sev snp is enabled.

guest_agent_enabled
boolean

Whether guest agent is enabled.

tpm_enabled
boolean

Whether tpm is enabled.

measured_boot_enabled
boolean

Select measured direct boot for the next start. This does not verify the running OS.

boot_image_id
string<uuid> | null

The UUID of a Boot Images library entry in the server’s team. Select this instead of uploading boot files.

measured_boot_kernel
file | null

The Linux kernel file, up to 64 MiB. Send both boot files together.

measured_boot_initrd
file | null

The matching initramfs file, up to 128 MiB.

measured_boot_kernel_sha256
string | null

The SHA-256 checksum calculated from your trusted kernel file.

Pattern: ^[a-fA-F0-9]{64}$
measured_boot_initrd_sha256
string | null

The SHA-256 checksum calculated from your trusted initramfs file.

Pattern: ^[a-fA-F0-9]{64}$
measured_boot_command_line
string | null

The exact kernel command line. Spaces are preserved; single quotes, backslashes and control characters are refused. Never include secrets.

Pattern: ~^[\x20-\x26\x28-\x5b\x5d-\x7e]{1,4096}$~

Response

The record, as a JSON object. There is no envelope.

bios_type
enum<string>
required

The boot firmware: seabios is legacy BIOS and ovmf is UEFI.

Available options:
seabios,
ovmf
Example:

"seabios"

sev_snp_enabled
boolean
required

Whether memory encryption is switched on for this server.

Example:

false

sev_snp_supported
boolean
required

Whether the host supports memory encryption. Enabling encryption is rejected if this is false.

Example:

false

guest_agent_enabled
boolean
required

Whether the guest agent is enabled.

Example:

true

tpm_enabled
boolean
required

Whether the server has a virtual TPM 2.0 device.

Example:

false