Services /

Start service build

Start a new build for the given combined or build service. If given a commit sha, it will build that commit. Otherwise, the most recent relevant commit will be built. If the service provided is a build service, a branch name or pull request to build from is required.

Required permission

Project > Services > Deployment > Deploy Build

Path parameters

projectId
string required
ID of the project
serviceId
string required
ID of the service

Request body

{object}
Start a build with the current settings

sha
string
Commit sha to build. If not provided, builds the most recent relevant commit.
min length
40
max length
40
branch
string
Branch to build from. If sha is not provided, the latest commit of this branch will be built. Only supported by build services. Build services require either branch or pullRequestId field, but cannot be provided with both.
pullRequestId
integer
ID of a pull request to build from. If sha is not provided, the latest commit of this pull request will be built. Only supported by build services. Build services require either branch or pullRequestId field, but cannot be provided with both.

{object}
Start a build with overrides for the current settings

sha
string
Commit sha to build. If not provided, builds the most recent relevant commit.
min length
40
max length
40
branch
string
Branch to build from. If sha is not provided, the latest commit of this branch will be built. Only supported by build services. Build services require either branch or pullRequestId field, but cannot be provided with both.
pullRequestId
integer
ID of a pull request to build from. If sha is not provided, the latest commit of this pull request will be built. Only supported by build services. Build services require either branch or pullRequestId field, but cannot be provided with both.
overrides
{object}
An optional object that may specify several different overrides on the build level.

buildArguments
{object}
Build arguments that will be set on this build only. In case of conflicts these values take precedence.

Response body

{object}
Response object.

data
{object} required
Result data.

id
string required
ID of the build.
branch
string
Name of the branch the built commit belongs to.
pullRequestId
number
ID of the pull request the commit belongs to.
sha
string
The sha of the built commit.
createdAt
string
Timestamp of the build initiation.
status
string
The status of the build.
concluded
boolean
Whether the build has finished.

API

CLI

JS Client

POST /v1/projects/{projectId}/services/{serviceId}/build

Example request

Request body

Start a build with the current settings

curl

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"sha":"262ed9817b3cad5142fbceabe0c9e371e390d616"}' \
  https://api.northflank.com/v1/projects/{projectId}/services/{serviceId}/build

Start a build with overrides for the current settings

curl

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"sha":"262ed9817b3cad5142fbceabe0c9e371e390d616","overrides":{"buildArguments":{"ARGUMENT_1":"abcdef","ARGUMENT_2":"12345"}}}' \
  https://api.northflank.com/v1/projects/{projectId}/services/{serviceId}/build

Example response

200 OK

Returns data about the build initiated

JSON

{
  "data": {
    "id": "joyous-view-6290",
    "branch": "main",
    "sha": "12c15e7ee25fd78f567ebf87f9178b8ad70025b3",
    "createdAt": "2021-07-28T15:55:38.296Z",
    "status": "PENDING",
    "concluded": false
  }
}