Builds

Get a build

What became of one build. The golden’s own filename is ours and is accepted nowhere here; what names the result is the ref you submitted: publish that same document with POST /templates and create a computer by its ref — see there for how the image is chosen and the template_image_preparing 409. error says why a failed one failed, which for a run: step is the end of that step’s own output.

Needs an account-wide key: one confined to a workspace is a 403.

Requires the viewer role or higher.

get/builds/{id}

Request

  • Base URL: https://app.mandala.computer/api/v1
  • URL: https://app.mandala.computer/api/v1/builds/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The build id.

Response

The build.

idstring

Stable identifier, e.g. bld-a1b2c3d4e5f6.

refstring

The document this was built from, as namespace/name@version.

statusstring

running, succeeded or failed.

errorstring

Why it failed, when it did. For a failing run: step this is the end of that step’s own output.

started_atstring

RFC 3339 timestamp.

finished_atstring

RFC 3339 timestamp. Absent while it is still running.

Changes

No recorded changes to this operation across all 1 revision of this API.