Skip to content

Delete an ISO image

DELETE /api/v2/vps/{id}/iso/{volid}

Deletes an ISO image you downloaded. The file is removed and cannot be restored. To take an image out of a CD/DVD drive without deleting it, use POST /api/v2/vps/{id}/iso/actions/unmount. Images Hostup shares with all customers cannot be deleted and return 403.

Authentication: An API key with the scopes write:vm and write:storage and vm:write. About keys and scopes

Request

Path parameters

idstringrequired
The VPS ID (vps_…).
volidstringrequired
The ISO ID (iso_…) from available[].id.

Example

DELETE /api/v2/vps/{id}/iso/{volid}
curl -X DELETE "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/iso/iso_01hxa3b4c5d6e7f8g9h0j1k2m3" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

204 The ISO image was deleted.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403The image is shared by Hostup or belongs to another account.
404Not found. The resource does not exist or is not owned by the caller; code is vps_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.