Skip to main content
POST
Retry a template build from its persisted definition

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Path Parameters

build_id
string
required

Body

application/json
tags
string[]

Optional replacement tags for the retry attempt.

base_image_auth
object
registry_auth
object[]

Fresh request-time BuildKit registry credentials for this retry.

build_secrets
object[]

Fresh request-time BuildKit secret values for this retry. When the original build used secrets, the retry must provide the same secret IDs again; historical request-time values are not replayed.

Response

Retry build accepted

build_id
string
required
template_id
string
required
name
string
required
tags
string[]
required
status
enum<string>
required
Available options:
waiting,
building,
ready,
error,
cancelled
build_backend
enum<string>
required

Template build backend. native is retained for declarative/OCI build requests and historical filters; Dockerfile build requests use buildkit.

Available options:
native,
buildkit
source_type
enum<string>
required
Available options:
declarative,
dockerfile,
oci_import,
template_base
canonical_ref
string
required
namespace_slug
string
required
visibility
enum<string>
required
Available options:
private,
public
created_at
string<date-time>
required
updated_at
string<date-time>
required
source_digest
string
context_digest
string
dockerfile_digest
string
build_config
object

Build VM resource configuration

triggered_by
string
queued_at
string<date-time>
started_at
string<date-time>
finished_at
string<date-time>
duration_ms
integer<uint64>
failure_phase
string
cache_summary
object
artifact_availability
object
promotability
object
retention_expires_at
string<date-time>
runtime_defaults
object

Effective runtime defaults retained for a built template. Environment values are intentionally omitted; only keys are exposed.

oci_metadata
object

OCI image metadata retained from Dockerfile or OCI imports. Volume declarations are metadata only and do not create persistent Nullspace volumes.

artifact_ids
string[]
retry_of_build_id
string
original_build_id
string
cancel_requested_at
string<date-time>
cancel_requested_by
string
cancellation_reason
string
error
string
error_detail
object