Skip to main content
GET
Get an image build

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

build_id
string
required

Response

Success.

build_id
string
required

Id of the build.

image_id
string
required

Id of the image the build produces.

status
string
required

A build is queued while it waits to start, then building, and it ends as ready, failed, or cancelled. Sail can add statuses later, so handle a value you do not recognize.

architecture
string
required

CPU architecture the image is built for.

created_at
string<date-time>
required

When the build was requested.

started_at
string<date-time> | null
required

When the build last started running. Null while the build is queued, and for a build that never ran.

finished_at
string<date-time> | null
required

When the build became ready, failed, or was cancelled. Null until then.

error_message
string | null
required

Why the build failed or was cancelled. Null for any other status.