v1

latestOpenAPI 3.1.02026-08-04151221521.2 KB

Builds

Prepare Remote Build Upload

Return a presigned URL for uploading a build context archive to GCS.

post/builds/prepare

agent_namestring required

Agent short name (without namespace prefix)

namespacestring required

Target namespace slug for the build

tagstring required

Image tag to build/push (typically git hash)

{
  "agent_name": "my-agent",
  "namespace": "acme",
  "tag": "abc123def456"
}

Successful Response

bucketstring required

GCS bucket where the context will be stored.

content_typestring required

Content-Type header that must be used for the upload.

expires_atstring date-time required

When the presigned URL expires.

image_urlstring required

Full Artifact Registry image URL that the build will push.

instructionsstring required

Human instructions for how to upload the context archive.

methodstring

HTTP method to use for the upload.

object_keystring required

GCS object key where the context will be stored.

upload_urlstring required

Presigned PUT URL for uploading the build context archive.

{
  "content_type": "application/gzip"
}