Skip to main content
GET
/
templates
/
{namespace}
/
{name}
/
{version}
/
build
Get build status
curl --request GET \
  --url https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build \
  --header 'Authorization: Bearer <token>'
{
  "ref": "<string>",
  "digest": "<string>",
  "golden_dir": "<string>",
  "build_time_ms": 123,
  "reused": true,
  "error": "<string>"
}
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

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

​
Response

​
status
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.
​
ref
string
Template ref.
​
digest
string
Content-addressed digest.
​
build_time_ms
integer
Build duration in milliseconds. Present when ready.
​
reused
boolean
Whether an existing golden was reused.
​
error
string
Failure reason. Present when status is failed.

​
Example

curl https://www.orgo.ai/api/templates/default/claude-code/1.0.0/build \
  -H "Authorization: Bearer $ORGO_API_KEY"

​
Response

{
  "ref": "default/claude-code@1.0.0",
  "digest": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "status": "ready",
  "build_time_ms": 118420,
  "reused": false
}

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.