Skip to main content
POST
/
v1
/
templates
/
builds
/
{build_id}
/
retry
Retry a template build from its persisted definition
import requests

url = "https://api.13-215-85-171.sslip.io/v1/templates/builds/{build_id}/retry"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
{
  "build_id": "<string>",
  "template_id": "<string>",
  "name": "<string>",
  "tags": [
    "<string>"
  ],
  "canonical_ref": "<string>",
  "namespace_slug": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "source_digest": "<string>",
  "context_digest": "<string>",
  "dockerfile_digest": "<string>",
  "build_config": {
    "vcpus": 123,
    "memory_mib": 123,
    "internet_access": true,
    "disk_mb": 513
  },
  "triggered_by": "<string>",
  "queued_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "finished_at": "2023-11-07T05:31:56Z",
  "duration_ms": 123,
  "failure_phase": "<string>",
  "cache_summary": {
    "final_artifact_hits": 123,
    "final_artifact_misses": 123,
    "final_artifact_bypasses": 123,
    "final_artifact_stores": 123,
    "layer_hits": 123,
    "layer_misses": 123,
    "layer_bypasses": 123,
    "layer_stores": 123,
    "file_blob_hits": 123,
    "file_blob_misses": 123,
    "file_blob_bypasses": 123,
    "file_blob_stores": 123
  },
  "artifact_availability": {
    "reason": "<string>"
  },
  "promotability": {
    "promotable": true,
    "reason": "<string>"
  },
  "retention_expires_at": "2023-11-07T05:31:56Z",
  "runtime_defaults": {
    "default_env_keys": [
      "<string>"
    ],
    "start_cmd": "<string>",
    "default_user": "<string>",
    "default_workdir": "<string>",
    "readiness": {
      "kind": "tcp",
      "port": 3000,
      "timeout_secs": 30,
      "interval_ms": 500,
      "startup_grace_secs": 2
    }
  },
  "oci_metadata": {
    "labels": {},
    "exposed_ports": [
      "<string>"
    ],
    "volumes": [
      "<string>"
    ],
    "healthcheck": {
      "test": [
        "<string>"
      ],
      "interval_ns": 123,
      "timeout_ns": 123,
      "start_period_ns": 123,
      "retries": 123,
      "mapped_readiness": {
        "kind": "tcp",
        "port": 3000,
        "timeout_secs": 30,
        "interval_ms": 500,
        "startup_grace_secs": 2
      }
    }
  },
  "artifact_ids": [
    "<string>"
  ],
  "retry_of_build_id": "<string>",
  "original_build_id": "<string>",
  "cancel_requested_at": "2023-11-07T05:31:56Z",
  "cancel_requested_by": "<string>",
  "cancellation_reason": "<string>",
  "error": "<string>",
  "error_detail": {
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "step_index": 123,
    "attempt": 123,
    "max_attempts": 123,
    "cache_subject": "<string>",
    "build_id": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

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