Skip to main content
POST
Cancel a build

Authorizations

x-api-key
string
header
required

Headers

x-selected-account-id
string | null

Path Parameters

build_id
string
required

Response

Successful Response

id
string
required

The unique identifier of the entity.

cloud_provider_build_id
string
required

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

agent_name
string
required

The name of the agent that this build belongs to

image_name
string
required

The name of the container image to build.

image_tag
string
required

The tag for the container image.

build_status
enum<string>
required

The current build lifecycle status

Available options:
queued,
running,
success,
failed,
cancelling,
cancelled,
deleting,
delete_failed,
timed_out,
error,
unknown
source_repo
string | null
required

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

source_commit
string | null
required

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

source_ref
string | null
required

Git branch or tag for source_commit, when resolvable.

source_subpath
string | null
required

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

working_tree_hash
string | null
required

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

source_dirty
boolean | null
required

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

account_id
string
required

The ID of the account that owns the given entity.

created_at
string<date-time>
required

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

created_by
Identity · object
required

The identity that created the entity.

object
string
default:agentex_cloud_build
Allowed value: "agentex_cloud_build"
agent_id
string

The UUID of the agent that this build belongs to

image_url
string

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

build_start_time
string<date-time>

When the cloud provider started the build

build_end_time
string<date-time>

When the cloud provider finished the build