Skip to main content
POST
Create an image build

Authorizations

x-api-key
string
header
required

Body

application/json
imageName
string
required

Name for the resulting image. Letters, numbers, dashes, and underscores only.

Maximum string length: 64
Pattern: ^[A-Za-z0-9_-]+$
inputSha256
string
required

SHA-256 of the image archive to upload.

Required string length: 64
Pattern: ^[A-Fa-f0-9]{64}$
inputSizeBytes
integer
required
Required range: x >= 1
inputFormat
enum<string>
default:rootfs_export_tar_gz

Archive format of the input.

Available options:
rootfs_export_tar_gz
sourcePlatform
enum<string>
default:linux/amd64

Platform of the source image.

Available options:
linux/amd64
imageConfigUser
string

Default user from the image config.

imageInit
object

Startup defaults to attach to the image.

Response

200 - application/json

Image build created with a presigned upload target

build
object
required
upload
object
required

Presigned upload target for the image archive.