v5

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-015725.9 KB
builds

Get Build

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

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

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