FLflox
builds

Get Build

Changed on

Return a single build by ID with its task sub-object and outputs.

get/api/v1/factory/builds/{build_id}

Request

  • The document declares no server URL.
  • Auth
    • HTTP bearer
    • or HTTP basic

Path parameters

build_idinteger required

Response

Successful Response

build_idinteger required
status'pending' | 'running' | 'completed' | 'failed' | 'timed_out' | 'cancelled' required

Effective status of a build, derived server-side and never stored.

A dispatched build's task lifecycle is authoritative, with timed_out reconstructed from a failed task whose error class is 'timeout'; a build cancelled before dispatch is cancelled; an undispatched, uncancelled build is pending. These six values are exactly what the derivation can emit; emittable, filterable, and the whole vocabulary are the same set. The member order here is the documentation order.

source_repo_urlstring required
source_commit_shastring required
nixpkgs_revisionstring required
systemstring required
attr_pathstring required
build_typestring required
catalog_namestring required
exit_codeinteger nullable
created_atstring date-time required

Changes

  • a0a0401010b7Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 76701e311542Revision changes
    • info

      added the optional property to the response with the status