Documentation | Build › Submit Build

Build

build

Methods

Submit Build -> { account_id, build_id, build_status, 8 more... }

post/v5/builds

Submit a container image build.

Upload a tar.gz archive containing the build context (Dockerfile and any files needed for the build) along with image name, tag, and optional build arguments.

Maximum file size: 500MB

Response fields

account_id: string

build_id: string

build_status: "queued" | "running" | "success" | 6 more...

The current build status from the cloud provider

created_at: string

(format: date-time)

created_by:

Identity

The identity that created the entity.

image_name: string

image_tag: string

build_end_time: string

Optional

(format: date-time)

When the cloud provider finished the build

build_start_time: string

Optional

(format: date-time)

When the cloud provider started the build

image_url: string

Optional

object: "agentex_cloud_build"

Optional

(default: "agentex_cloud_build")

Request example

curl https://api.egp.scale.com/v5/builds \
    -H 'Content-Type: multipart/form-data' \
    -H "x-api-key: $SGP_API_KEY" \
    -F context_archive=context_archive \
    -F image_name=image_name

200Example

{
  "account_id": "account_id",
  "build_id": "build_id",
  "build_status": "queued",
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by": {
    "id": "id",
    "type": "user",
    "object": "identity"
  },
  "image_name": "image_name",
  "image_tag": "image_tag",
  "build_end_time": "2019-12-27T18:11:19.117Z",
  "build_start_time": "2019-12-27T18:11:19.117Z",
  "image_url": "image_url",
  "object": "agentex_cloud_build"
}

Get Build -> { account_id, build_id, build_status, 8 more... }

get/v5/builds/{build_id}

Get a build by ID, including current status from the cloud provider.

List Builds -> CursorPage<{ account_id, build_id, build_status, 8 more... }>

get/v5/builds

List Builds

Stream Build Logs ->

StreamChunk

get/v5/builds/{build_id}/logs

Stream build logs via Server-Sent Events (SSE).

Returns a streaming response with content-type text/event-stream. Each log line is sent as an SSE data event.

Cancel Build -> unknown

post/v5/builds/{build_id}/cancel

Cancel a pending or running build.

Returns 202 Accepted — the actual cancellation happens asynchronously via a Temporal workflow.

Domain types

BuildCancelResponse = unknown

BuildCreateResponse = { account_id, build_id, build_status, 8 more... }

BuildListResponse = { account_id, build_id, build_status, 8 more... }

BuildRetrieveResponse = { account_id, build_id, build_status, 8 more... }

StreamChunk = { line }

A single log line from the build process.