Get job build | Jobs | Northflank API docs
v1
Double column
API
CLI
JS Client

Jobs /

Get job build

Gets information about a build for the job

Required permission

Project > Jobs > Deployment > Deploy Build

Path parameters

    • projectId

      string required

      ID of the project

    • jobId

      string required

      ID of the job

    • buildId

      string required

      ID of the job build

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.

      • status

        string

        The status of the build.

        one of
        QUEUED, PENDING, STARTING, CLONING, BUILDING, UPLOADING, ABORTED, FAILURE, SUBMISSION_FAILURE, SUCCESS, CRASHED
      • sha

        string

        The sha of the built commit.

      • concluded

        boolean

        Whether the build has finished.

      • createdAt

        string

        Timestamp of the build initiation.

      • success

        boolean

        Whether the build was successful.

      • message

        string

        Description of the build status.

      • buildConcludedAt

        number

        Timestamp of the build concluding.

API
CLI
JS Client

GET /v1/projects/{projectId}/jobs/{jobId}/build/{buildId}

Example response

200 OK

Returns data about the specified build.

JSON

{
  "data": {
    "id": "joyous-view-6290",
    "branch": "main",
    "status": "SUCCESS",
    "sha": "12c15e7ee25fd78f567ebf87f9178b8ad70025b3",
    "concluded": true,
    "createdAt": "2021-07-28T15:55:38.296Z",
    "success": true,
    "message": "Image successfully built",
    "buildConcludedAt": 1606237973
  }
}

© 2024 Northflank Ltd. All rights reserved.