Skip to content

create component build

POST
/v1/components/{component_id}/builds

Authorizations

Parameters

Path Parameters

component_id
required
string

Component ID

Request Body

Input

object
git_ref
string
use_latest
boolean

Responses

201

Created

object
component_config_connection_id
string
component_config_version
integer
component_id

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

string
component_name
string
created_at
string
created_by_id
string
git_ref
string
id
string
install_deploys
Array<object>
object
build_id
string
component_config_version
integer
component_id
string
component_name
string
created_at
string
created_by_id
string
id
string
install_component_id
string
install_deploy_type
string
Allowed values: release install teardown plan-only
install_id

Fields that are de-nested at read time using AfterQuery

string
log_stream
object
attrs
object
key
additional properties
string
created_at
string
created_by_id
string
id
string
open
boolean
org_id
string
owner_id
string
owner_type
string
runner_api_url
string
updated_at
string
write_token
string
release_id
string
runner_jobs

Runner details

Array<object>
object
available_timeout

Available timeout is how long a job can be marked as “available” before being requeued

integer
created_at
string
created_by_id
string
execution_count
integer
execution_time
integer
execution_timeout

Execution timeout is how long a job can be marked as “exeucuting” before being requeued

integer
executions
Array<object>
object
created_at
string
created_by_id
string
id
string
org_id
string
outputs
object
created_at
string
created_by_id
string
id
string
org_id
string
outputs
object
key
additional properties
object
outputs_json
string
runner_job_execution_id
string
updated_at
string
result
object
created_at
string
created_by_id
string
error_code
integer
error_metadata
object
key
additional properties
string
id
string
org_id
string
runner_job_execution_id
string
success
boolean
updated_at
string
runner_job_id
string
status
string
Allowed values: pending initializing in-progress cleaning-up finished failed timed-out not-attempted cancelled unknown
updated_at
string
final_runner_job_execution_id
string
finished_at
string
group
string
Allowed values: health-checks sync build deploy sandbox runner operations actions "" any
id
string
log_stream_id
string
max_executions
integer
operation
string
Allowed values: exec apply destroy plan-only build unknown
org_id
string
outputs
object
key
additional properties
any
outputs_json
Array<integer>
overall_timeout

Overall timeout is how long a job can be attempted, before being cancelled

integer
owner_id
string
owner_type
string
queue_timeout

Queue timeout is how long a job can be queued, before being made available

integer
runner_id
string
started_at
string
status
string
Allowed values: queued available in-progress finished failed timed-out not-attempted cancelled unknown
status_description
string
type
string
Allowed values: health-check docker-build container-image-build terraform-module-build helm-chart-build noop-build oci-sync noop-sync terraform-deploy helm-chart-deploy job-deploy noop-deploy shut-down noop sandbox-terraform runner-helm runner-terraform runner-local actions-workflow
updated_at
string
status
string
status_description
string
updated_at
string
log_stream
object
attrs
object
key
additional properties
string
created_at
string
created_by_id
string
id
string
open
boolean
org_id
string
owner_id
string
owner_type
string
runner_api_url
string
updated_at
string
write_token
string
releases
Array<object>
object
build_id
string
created_at
string
created_by_id
string
id
string
release_steps
Array<object>
object
component_release_id

Parent release ID

string
created_at
string
created_by_id
string
delay

Fields to control the delay of the individual step, as this is set based on the parent strategy

string
id
string
install_deploys
Array<object>
object
build_id
string
component_config_version
integer
component_id
string
component_name
string
created_at
string
created_by_id
string
id
string
install_component_id
string
install_deploy_type
string
Allowed values: release install teardown plan-only
install_id

Fields that are de-nested at read time using AfterQuery

string
log_stream
object
attrs
object
key
additional properties
string
created_at
string
created_by_id
string
id
string
open
boolean
org_id
string
owner_id
string
owner_type
string
runner_api_url
string
updated_at
string
write_token
string
release_id
string
runner_jobs

Runner details

Array<object>
object
available_timeout

Available timeout is how long a job can be marked as “available” before being requeued

integer
created_at
string
created_by_id
string
execution_count
integer
execution_time
integer
execution_timeout

Execution timeout is how long a job can be marked as “exeucuting” before being requeued

integer
executions
Array<object>
object
created_at
string
created_by_id
string
id
string
org_id
string
outputs
object
created_at
string
created_by_id
string
id
string
org_id
string
outputs
object
key
additional properties
object
outputs_json
string
runner_job_execution_id
string
updated_at
string
result
object
created_at
string
created_by_id
string
error_code
integer
error_metadata
object
key
additional properties
string
id
string
org_id
string
runner_job_execution_id
string
success
boolean
updated_at
string
runner_job_id
string
status
string
Allowed values: pending initializing in-progress cleaning-up finished failed timed-out not-attempted cancelled unknown
updated_at
string
final_runner_job_execution_id
string
finished_at
string
group
string
Allowed values: health-checks sync build deploy sandbox runner operations actions "" any
id
string
log_stream_id
string
max_executions
integer
operation
string
Allowed values: exec apply destroy plan-only build unknown
org_id
string
outputs
object
key
additional properties
any
outputs_json
Array<integer>
overall_timeout

Overall timeout is how long a job can be attempted, before being cancelled

integer
owner_id
string
owner_type
string
queue_timeout

Queue timeout is how long a job can be queued, before being made available

integer
runner_id
string
started_at
string
status
string
Allowed values: queued available in-progress finished failed timed-out not-attempted cancelled unknown
status_description
string
type
string
Allowed values: health-check docker-build container-image-build terraform-module-build helm-chart-build noop-build oci-sync noop-sync terraform-deploy helm-chart-deploy job-deploy noop-deploy shut-down noop sandbox-terraform runner-helm runner-terraform runner-local actions-workflow
updated_at
string
status
string
status_description
string
updated_at
string
requested_install_ids

When a step is created, a set of installs are targeted. However, by the time the release step goes out, the install might have been setup in any order of ways.

Array<string>
status
string
status_description
string
updated_at
string
status
string
status_description
string
total_release_steps
integer
updated_at
string
runner_job

Runner details

object
available_timeout

Available timeout is how long a job can be marked as “available” before being requeued

integer
created_at
string
created_by_id
string
execution_count
integer
execution_time
integer
execution_timeout

Execution timeout is how long a job can be marked as “exeucuting” before being requeued

integer
executions
Array<object>
object
created_at
string
created_by_id
string
id
string
org_id
string
outputs
object
created_at
string
created_by_id
string
id
string
org_id
string
outputs
object
key
additional properties
object
outputs_json
string
runner_job_execution_id
string
updated_at
string
result
object
created_at
string
created_by_id
string
error_code
integer
error_metadata
object
key
additional properties
string
id
string
org_id
string
runner_job_execution_id
string
success
boolean
updated_at
string
runner_job_id
string
status
string
Allowed values: pending initializing in-progress cleaning-up finished failed timed-out not-attempted cancelled unknown
updated_at
string
final_runner_job_execution_id
string
finished_at
string
group
string
Allowed values: health-checks sync build deploy sandbox runner operations actions "" any
id
string
log_stream_id
string
max_executions
integer
operation
string
Allowed values: exec apply destroy plan-only build unknown
org_id
string
outputs
object
key
additional properties
any
outputs_json
Array<integer>
overall_timeout

Overall timeout is how long a job can be attempted, before being cancelled

integer
owner_id
string
owner_type
string
queue_timeout

Queue timeout is how long a job can be queued, before being made available

integer
runner_id
string
started_at
string
status
string
Allowed values: queued available in-progress finished failed timed-out not-attempted cancelled unknown
status_description
string
type
string
Allowed values: health-check docker-build container-image-build terraform-module-build helm-chart-build noop-build oci-sync noop-sync terraform-deploy helm-chart-deploy job-deploy noop-deploy shut-down noop sandbox-terraform runner-helm runner-terraform runner-local actions-workflow
updated_at
string
status
string
status_description
string
updated_at
string
vcs_connection_commit
object
author_email
string
author_name
string
component_config_connection_id
string
created_at
string
created_by_id
string
id
string
message
string
sha
string
updated_at
string

400

Bad Request

object
description
string
error
string
user_error
boolean

401

Unauthorized

object
description
string
error
string
user_error
boolean

403

Forbidden

object
description
string
error
string
user_error
boolean

404

Not Found

object
description
string
error
string
user_error
boolean

500

Internal Server Error

object
description
string
error
string
user_error
boolean