Build the source's branch head now: the same as a source sync.

POST

/api/v1/projects/{project}/environments/{environment}/apps/{app}/builds

const url = 'https://example.com/api/v1/projects/example/environments/example/apps/example/builds';
const options = {method: 'POST'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.com/api/v1/projects/example/environments/example/apps/example/builds

Parameters

Path Parameters

project

required

string

Project name

environment

required

string

Environment short name

app

required

string

App name

Responses

202

The sync was queued

application/json

A build of the source head was asked for: the head is read, then built unless it is already.

object

syncOperation

required

The sync that reads the head and queues the build.

string

build

One of:

null
object

null

The newest build, when one exists.

object

required

string

attempt

required

1 for the first attempt; an infrastructure retry is the next one.

integer format: int32

repository

required

string

branch

required

string

commit

required

string

strategy

required

auto, dockerfile or railpack, as configured.

string

phase

required

queued, blocked, preparing, running, publishing, verifyingOutput, cancelRequested, cancelling, succeeded, failed or cancelled.

string

blockedReason

string | null

failure

BuildError, OutOfMemory, DiskFull, DeadlineExceeded, LostWorker, SourceUnavailable, OutputRejected, …

string | null

failureDetail

string | null

image

repository@digest, once the registry confirmed it.

string | null

release

string | null

deployment

string | null

deployDecision

deployed, or why the build did not deploy (StaleSource, BuildConfigChanged, NotAutomatic, …).

string | null

cancelRequested

required

boolean

createdAt

required

integer format: int64

startedAt

integer | null format: int64

finishedAt

integer | null format: int64

stages

The stages in order, once the build reported them.

Array<object>

object

name

required

string

Allowed values: clone plan build scan push deploy

status

required

string

Allowed values: pending running succeeded failed skipped

startedAt

integer | null format: int64

finishedAt

integer | null format: int64

detail

string | null

Example

{
  "build": {
    "stages": [
      {
        "name": "clone",
        "status": "pending"
      }
    ]
  }
}

403

application/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

404

application/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

409

The app has no Git source

application/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}