Skip to main content
GET
Get build status
Returns the current build state of a version. Poll this after Build template until status is ready, or stream build logs for live output.

Path parameters

string
required
Template namespace.
string
required
Template name.
string
required
Version (semver).

Response

string
One of:
  • not_built - no golden snapshot yet. Call Build template.
  • building - a build is in progress.
  • ready - built and launchable.
  • failed - the last build failed. See error.
string
Template ref.
string
Content-addressed digest.
integer
Build duration in milliseconds. Present when ready.
boolean
Whether an existing golden was reused.
string
Failure reason. Present when status is failed.

Example

Response

Authorizations

Authorization
string
header
required

API key authentication. Get your key at orgo.ai/workspaces

Path Parameters

namespace
string
required
name
string
required
version
string
required

Response

Build status

ref
string
digest
string
status
enum<string>
Available options:
ready,
building,
failed,
not_built
golden_dir
string
build_time_ms
integer

Build duration in milliseconds. Present when ready.

reused
boolean

Whether an existing golden with the same digest was reused.

error
string

Failure reason. Present when status is failed.