Builds

Prepare Remote Build Upload

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

post/builds/prepare

Request

Base URL
https://docs.terminaluse.com (the document declares no server; this is the origin it was published from)
Auth
none declared
TypeScript
https://skmtc.dev/terminaluse/apis/sb0-api/docs/builds/prepare/post.ts
A function with typed inputs. Its response is checked against the schema.

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"
}

No recorded changes to this operation across all 1 revision of this API.