---
title: "Update/reload instant device"
method: PUT
path: "/compute/{deviceId}"
tags: ["Compute Devices"]
---

# Update/reload instant device

`PUT /compute/{deviceId}`

## Query parameters

- `skipPowerCheck` boolean

## Headers

- `X-Fields` string, mask

## Request body

- BareMetalDeviceUpdate
  - `appName` string — The name of the application to provision on this device. Must match the name field of an application
  - `appUserData` object — User data for specific application if reloading using app option
  - `customIPXEScriptContents` string — Contents of iPXE script if not specifying URL. If both script URL and contents are not specified, the last iPXE script contents are used if OS selection requires an iPXE script.
  - `customIPXEScriptURL` string — URL to download custom iPXE script if not specifying contents in entirety. If both script URL and contents are not specified, the last iPXE script contents are used if OS selection requires an iPXE script.
  - `forceReload` boolean — Whether to force a reload even if fields have not changed
  - `hostname` string, required — A FQDN for the device. For example: `example.hivelocity.net`
  - `ignitionId` integer — The unique ID of an Ignition File for FlatcarOS provisions.
  - `osName` string — The name of the Operating System to provision on this device. Must match name of an operating system product option.
  - `publicSshKeyId` integer
  - `script` string — A Cloud-Init script or a post-install script (Bash for Linux or Powershell for Windows).
  - `tags` string[]

## Response `200`

Device updated.

- BareMetalDevice
  - `appName` string — If device was deployed with as an application, this is the name of the application used.
  - `customIPXEScriptContents` string — Contents of custom iPXE used to provision device
  - `customIPXEScriptURL` string — URL of custom iPXE script used to provision device
  - `deviceId` integer — The unique ID of the device.
  - `hostname` string — The user specified hostname for the device. Note: If the hostname is changed in the portal or on the device itself this value may not reflect the actual hostname on the device.
  - `locationName` string — A facility code. For example `NYC1`.
  - `orderId` integer — The unique ID of the order for this device.
  - `osName` string — The name of the operating system currently installed on this device. Note: If you manually reload your own OS over IPMI this value may not reflect the OS currently on your device.
  - `period` string — This device's service's billing period.
  - `powerStatus` string — ON|OFF
  - `primaryIp` string — The first assigned public IP for accessing this device.
  - `productId` integer — The unique ID of the product associated with this device.
  - `productName` string — The name of the product associated with this device.
  - `publicSshKeyId` integer
  - `script` string — The post-install/cloud-init script used during this device's last provisioning.
  - `serviceId` integer — The unique ID of the service associated with this device.
  - `tags` string[] — User specified values.
  - `vlanId` integer

## Other responses

- `400` — Invalid device parameters.
- `403` — You have not been granted permission to complete this action. Please contact your account manager to grant the proper permission.
- `404` — Device Not Found

---

[API](https://skmtc.net/hivelocity/apis/hivelocity-api.md) · [All operations](https://skmtc.net/hivelocity/apis/hivelocity-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hivelocity/hivelocity-api/revisions/ee6b717b5015/schema)