Skip to content
Start here

Builds

List builds by script
GET/accounts/{account_id}/builds/workers/{external_script_id}/builds
Get build by UUID
GET/accounts/{account_id}/builds/builds/{build_uuid}
Cancel build
PUT/accounts/{account_id}/builds/builds/{build_uuid}/cancel
ModelsExpand Collapse
BuildListResponse = object { build_outcome, build_trigger_metadata, build_uuid, 8 more }
build_outcome: optional "success" or "fail" or "skipped" or 2 more
One of the following:
"success"
"fail"
"skipped"
"cancelled"
"terminated"
build_trigger_metadata: optional object { author, branch, build_command, 11 more }
author: optional string
branch: optional string

Git branch name.

build_command: optional string
build_token_name: optional string
build_token_uuid: optional string

Build token UUID.

formatuuid
build_trigger_source: optional "push" or "pull_request" or "manual" or "api"
One of the following:
"push"
"pull_request"
"manual"
"api"
commit_hash: optional string

Git commit hash

commit_message: optional string
deploy_command: optional string
environment_variables: optional map[string]
provider_account_name: optional string
provider_type: optional "github"
repo_name: optional string
root_directory: optional string

Root directory path.

build_uuid: optional string

Build UUID.

formatuuid
created_on: optional string
formatdate-time
initializing_on: optional string
formatdate-time
modified_on: optional string
formatdate-time
pull_request: optional object { created_on, pull_request_url }
created_on: optional string
formatdate-time
pull_request_url: optional string
formaturi
running_on: optional string
formatdate-time
status: optional "queued" or "initializing" or "running" or "stopped"
One of the following:
"queued"
"initializing"
"running"
"stopped"
stopped_on: optional string
formatdate-time
trigger: optional object { branch_excludes, branch_includes, build_caching_enabled, 12 more }

Trigger information without build_token_uuid

branch_excludes: optional array of string
branch_includes: optional array of string
build_caching_enabled: optional boolean
build_command: optional string
created_on: optional string
formatdate-time
deleted_on: optional string
formatdate-time
deploy_command: optional string
external_script_id: optional string

External script identifier.

modified_on: optional string
formatdate-time
path_excludes: optional array of string
path_includes: optional array of string
repo_connection: optional object { created_on, deleted_on, modified_on, 6 more }
created_on: optional string
formatdate-time
deleted_on: optional string
formatdate-time
modified_on: optional string
formatdate-time
provider_account_id: optional string

Provider account identifier.

provider_account_name: optional string
provider_type: optional "github"
repo_connection_uuid: optional string

Repository connection UUID.

formatuuid
repo_id: optional string

Repository identifier.

repo_name: optional string
root_directory: optional string

Root directory path.

trigger_name: optional string
trigger_uuid: optional string

Trigger UUID.

formatuuid
BuildGetResponse = object { build_outcome, build_trigger_metadata, build_uuid, 8 more }
build_outcome: optional "success" or "fail" or "skipped" or 2 more
One of the following:
"success"
"fail"
"skipped"
"cancelled"
"terminated"
build_trigger_metadata: optional object { author, branch, build_command, 11 more }
author: optional string
branch: optional string

Git branch name.

build_command: optional string
build_token_name: optional string
build_token_uuid: optional string

Build token UUID.

formatuuid
build_trigger_source: optional "push" or "pull_request" or "manual" or "api"
One of the following:
"push"
"pull_request"
"manual"
"api"
commit_hash: optional string

Git commit hash

commit_message: optional string
deploy_command: optional string
environment_variables: optional map[string]
provider_account_name: optional string
provider_type: optional "github"
repo_name: optional string
root_directory: optional string

Root directory path.

build_uuid: optional string

Build UUID.

formatuuid
created_on: optional string
formatdate-time
initializing_on: optional string
formatdate-time
modified_on: optional string
formatdate-time
pull_request: optional object { created_on, pull_request_url }
created_on: optional string
formatdate-time
pull_request_url: optional string
formaturi
running_on: optional string
formatdate-time
status: optional "queued" or "initializing" or "running" or "stopped"
One of the following:
"queued"
"initializing"
"running"
"stopped"
stopped_on: optional string
formatdate-time
trigger: optional object { branch_excludes, branch_includes, build_caching_enabled, 12 more }

Trigger information without build_token_uuid

branch_excludes: optional array of string
branch_includes: optional array of string
build_caching_enabled: optional boolean
build_command: optional string
created_on: optional string
formatdate-time
deleted_on: optional string
formatdate-time
deploy_command: optional string
external_script_id: optional string

External script identifier.

modified_on: optional string
formatdate-time
path_excludes: optional array of string
path_includes: optional array of string
repo_connection: optional object { created_on, deleted_on, modified_on, 6 more }
created_on: optional string
formatdate-time
deleted_on: optional string
formatdate-time
modified_on: optional string
formatdate-time
provider_account_id: optional string

Provider account identifier.

provider_account_name: optional string
provider_type: optional "github"
repo_connection_uuid: optional string

Repository connection UUID.

formatuuid
repo_id: optional string

Repository identifier.

repo_name: optional string
root_directory: optional string

Root directory path.

trigger_name: optional string
trigger_uuid: optional string

Trigger UUID.

formatuuid
BuildCancelResponse = object { build_outcome, build_uuid, stopped_on }
build_outcome: optional "success" or "fail" or "skipped" or 2 more
One of the following:
"success"
"fail"
"skipped"
"cancelled"
"terminated"
build_uuid: optional string

Build UUID.

formatuuid
stopped_on: optional string
formatdate-time

BuildsLogs

Get build logs
GET/accounts/{account_id}/builds/builds/{build_uuid}/logs
ModelsExpand Collapse
LogGetResponse = object { cursor, lines, truncated }
cursor: optional string

Pagination cursor for log retrieval.

lines: optional array of array of number or string
One of the following:
number

Unix epoch timestamp

string

Log message

truncated: optional boolean