Skip to main content
POST
create component build

Authorizations

Authorization
string
header
required

Type "Bearer" followed by a space and token.

Path Parameters

component_id
string
required

component ID

Body

application/json

Input

git_ref
string
use_latest
boolean

Response

Created

app_branch_run_id
string
checksum
string

checksum of our intermediate component config

component_config_connection
object
component_config_connection_id
string

DEPRECATED: will retain the field to connect against the last component config connection that set this build

component_config_version
integer
component_id
string

Read-only fields set on the object to de-nest data

component_name
string
created_at
string
created_by
object
created_by_id
string
git_ref
string
id
string
install_deploys
object[]
log_stream
object
no_op
boolean

NoOp is true when the runner detected SourceDigest matches the previous build's SourceDigest and skipped the artifact push.

Downstream contract:

  • The build is still marked Active because the bytes it represents are deployable (they live in the install registry under the prior build that pushed them).
  • No new install deploys are auto-queued for a NoOp build; the dep-aware deploy path handles fan-out for installs that depend on the underlying image.
  • pollForDeployableBuild treats NoOp builds as Active without any special-casing because the deployable artifact at the same SourceDigest is already present in the install registry from the prior build.
policy_reports
object[]
queue_signal
object

QueueSignal is the signal enqueued when this build was created via the queue path

releases
object[]
resolved_at
string

ResolvedAt is when the runner resolved SourceRef to SourceDigest.

resolved_tag
string

ResolvedTag is the tag the runner actually pulled from. For digest-pinned refs this is empty. For mutable/semver refs this is the concrete tag the runner selected (e.g. "1.25.5" even if SourceRef pinned "1.25.3" with a "~1.25.0" update_policy constraint).

runner_job
object

runner details

source_checksum
string

checksum of the component's source directory at build time

source_digest
string

SourceDigest is the manifest list digest of the resolved source ref, e.g. "sha256:abc...". This is the canonical content address of what was pulled and is used for build dedup.

source_image
string

SourceImage is the repository portion of SourceRef without tag/digest, e.g. "nginx".

source_media_type
string

SourceMediaType records the media type of the resolved manifest (image, image index, OCI artifact, etc.) for downstream rendering decisions.

source_ref
string

Source identity for image-type builds.

SourceRef is what the user wrote in the spec, e.g. "nginx:1.25.3" or "myimage@sha256:...". Always populated for image-type builds so we have a permanent record of what was requested at build time.

status
string
status_description
string
status_v2
object
updated_at
string
vcs_connection_commit
object