v4

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-05-09283767.7 KB

builds

Mint signed URLs for uploading a build context tarball

Returns a pair of short-lived signed URLs targeting a per-org staging location. Tar+gzip your build-context directory, PUT it to uploadUrl with Content-Type: application/gzip, then pass downloadUrl as contextDownloadUrl on POST /v1/builds.

Unlike /v1/vms/{id}/files/presign, this endpoint isn't keyed to a specific VM — context uploads happen before the build VM exists.

post/v1/build-contexts/presign

Response

Signed URLs + upload size ceiling

uploadUrlstring uri required

Presigned PUT URL for the staging object. Accepts Content-Type: application/octet-stream. Used by the client on upload, or by the VM (via an exec'd curl -T -) on download.

downloadUrlstring uri required

Presigned GET URL for the same staging object. Used by the VM (via POST /v1/vms/{id}/files/fetch) on upload, or by the client (via httpx.stream / curl) on download.

expiresInSecinteger required

Lifetime of both URLs in seconds.

maxUploadBytesinteger required

Upper bound on upload size (equals the VM's disk size in bytes).