Skip to content

create an action workflow run for an install

POST
/v1/installs/{install_id}/action-workflows/runs

Authorizations

Parameters

Path Parameters

install_id
required
string

Install ID

Request Body

Input

object
action_workflow_config_id
required
string

Responses

201

Created

object
action_workflow_config_id
string
config
object
action_workflow_id
string
app_config_id

This belongs to an app config id

string
app_id
string
created_at
string
created_by_id
string
id
string
steps
Array<object>
object
action_workflow_config_id
string
app_config_id

This belongs to an app config id

string
app_id
string
connected_github_vcs_config
object
branch
string
component_config_id

Parent component

string
component_config_type
string
created_at
string
created_by_id
string
directory
string
id
string
repo
string
repo_name
string
repo_owner
string
updated_at
string
vcs_connection
object
created_at
string
created_by_id
string
github_install_id
string
id
string
updated_at
string
vcs_connection_commit
Array<object>
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
vcs_connection_id
string
created_at
string
created_by_id
string
env_vars
object
key
additional properties
string
id
string
idx
integer
name

Metadata

string
previous_step_id
string
public_git_vcs_config

All the details needed for a step

object
branch
string
component_config_id
string
component_config_type
string
created_at
string
created_by_id
string
directory
string
id
string
repo

Actual configuration

string
updated_at
string
updated_at
string
triggers
Array<object>
object
action_workflow_config_id
string
app_config_id

This belongs to an app config id

string
app_id
string
created_at
string
created_by_id
string
cron_schedule
string
id
string
type

Individual fields for different types

string
Allowed values: manual cron post_install
updated_at
string
updated_at
string
created_at
string
created_by_id
string
id
string
install_id
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_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
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

TODO(jm): add richer information on the error or other tied to a job execution.

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
group
string
Allowed values: health-checks sync build deploy sandbox runner operations user "" any
id
string
log_stream_id
string
max_executions
integer
operation
string
Allowed values: exec apply destroy plan-only build unknown
org_id
string
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
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
updated_at
string
status
string
status_description
string
trigger_type
string
Allowed values: manual cron post_install
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