HYhyperbrowser
Images

Create an image build

Changed on
post/api/images/builds

Request

Request body

imageNamestring required

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

inputSha256string required

SHA-256 of the image archive to upload.

inputSizeBytesinteger required
inputFormat'rootfs_export_tar_gz' | 'dockerfile_context_tar_gz' | 'dockerfile_context_manifest_v1' | 'docker_image_manifest_v1'

Input archive or manifest format. GPU publication requires dockerfile_context_tar_gz or dockerfile_context_manifest_v1. Use the CLI to package the context and manage uploads.

sourcePlatform'linux/amd64'

Platform of the source image.

imageConfigUserstring

Default user from the image config.

enableGPUBuildsboolean

Also publish an image for GPU sandboxes. Requires GPU access and a Dockerfile context input format. GPUs are attached only when a sandbox runs, not during image builds. Wait for gpuImageReady before GPU creation.

dockerfilePathstring

Dockerfile path relative to the build context for remote Dockerfile builds.

contextManifestobject

Build context manifest for dockerfile_context_manifest_v1. Generated by the CLI when packaging a remote build context.

dockerImageManifestobject

Docker image manifest for docker_image_manifest_v1. Generated by the CLI for local Docker image exports. This format does not support GPU publication.

Response

Image build created with a presigned upload target

Changes

  • 710eb2ccc708Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new docker_image_manifest_v1 enum value to the request property

    • info

      added the new dockerfile_context_manifest_v1 enum value to the request property

    • info

      added the new dockerfile_context_tar_gz enum value to the request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 69aa004ce41bRevision changes
    • info

      endpoint added