Upload a new custom image to S3

POST

/api/v2/vmware/vpc/{vpc_id}/hpc/images/

With custom image templates, you can capture an image of a Bare Metal GPU server to replicate its configuration with minimal changes in the order process. Image templates provide an imaging option for all Bare Metal GPU servers, regardless of operating system. When your image template is complete, you can use it to create another Bare Metal GPU server.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Example

{
    "name": "string",
    "size": 0,
    "sha256": "string",
    "vpcId": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v2/vmware/vpc//hpc/images/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "size": 0,
    "sha256": "string",
    "vpcId": "string"
}'

Responses

🟢201Created

application/json

Image registered successfully.

Body

Example

{
    "message": "string",
    "data": {
        "image_id": "string",
        "name": "string",
        "description": "string",
        "created_at": "2019-08-24T14:15:22.123Z"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Modified at 2025-08-25 12:12:28

List all custom images

Get presigned upload URLs