Get a build

client.build.retrieve(, ?): AgentexCloudBuild { id, account_id, agent_name, 17 more }

GET/v5/builds/{build_id}

Retrieve a single build by its ID, including its current lifecycle status.

Because builds run asynchronously after submission, the status returned here reflects the latest known state and may still be queued or running; call this endpoint again to observe progression to a terminal state such as success, failed, cancelled, or timed out. Responds with a not-found error if no such build exists for the caller’s account.

ParametersExpand Collapse

buildID: string

ReturnsExpand Collapse

AgentexCloudBuild { id, account_id, agent_name, 17 more }

id: string

The unique identifier of the entity.

account_id: string

The ID of the account that owns the given entity.

agent_name: string

The name of the agent that this build belongs to

build_status: "queued" | "running" | "success" | 8 more

The current build lifecycle status

One of the following:

"queued"

"running"

"success"

"failed"

"cancelling"

"cancelled"

"deleting"

"delete_failed"

"timed_out"

"error"

"unknown"

cloud_provider_build_id: string

The unique identifier of the build from the cloud provider, or an internal UUID when an existing image is copied without a provider build.

created_at: string

The date and time when the entity was created in ISO format.

formatdate-time

created_by: Identity { id, type, object }

The identity that created the entity.

id: string

type: "user" | "service_account"

One of the following:

"user"

"service_account"

object?: "identity"

image_name: string

The name of the container image to build.

image_tag: string

The tag for the container image.

source_commit: string | null

Git commit the build context was at, when a git work tree.

source_dirty: boolean | null

Whether the work tree had uncommitted changes at build time (null outside git).

source_ref: string | null

Git branch or tag for source_commit, when resolvable.

source_repo: string | null

Normalized git remote the build context came from (host/path, no credentials).

source_subpath: string | null

Build-context path relative to the repo root (which agent, in a monorepo).

working_tree_hash: string | null

Deterministic SHA-256 content hash of the build inputs (not the tarball).

agent_id?: string

The UUID of the agent that this build belongs to

build_end_time?: string

When the cloud provider finished the build

formatdate-time

build_start_time?: string

When the cloud provider started the build

formatdate-time

image_url?: string

The URL of the container image. This is not guaranteed to be present until the build is complete.

object?: "agentex_cloud_build"

Get a build

import SGPClient from 'scale-gp';

const client = new SGPClient({
  accountID: 'My Account ID',
  apiKey: process.env['SGP_API_KEY'], // This is the default and can be omitted
});

const agentexCloudBuild = await client.build.retrieve('build_id');

console.log(agentexCloudBuild.id);

{
  "id": "id",
  "account_id": "account_id",
  "agent_name": "agent_name",
  "build_status": "queued",
  "cloud_provider_build_id": "cloud_provider_build_id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by": {
    "id": "id",
    "type": "user",
    "object": "identity"
  },
  "image_name": "image_name",
  "image_tag": "image_tag",
  "source_commit": "source_commit",
  "source_dirty": true,
  "source_ref": "source_ref",
  "source_repo": "source_repo",
  "source_subpath": "source_subpath",
  "working_tree_hash": "working_tree_hash",
  "agent_id": "agent_id",
  "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"
}

Returns Examples

{
  "id": "id",
  "account_id": "account_id",
  "agent_name": "agent_name",
  "build_status": "queued",
  "cloud_provider_build_id": "cloud_provider_build_id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by": {
    "id": "id",
    "type": "user",
    "object": "identity"
  },
  "image_name": "image_name",
  "image_tag": "image_tag",
  "source_commit": "source_commit",
  "source_dirty": true,
  "source_ref": "source_ref",
  "source_repo": "source_repo",
  "source_subpath": "source_subpath",
  "working_tree_hash": "working_tree_hash",
  "agent_id": "agent_id",
  "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"
}