Orgo - Cloud computers for AI agents

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>'

import requests

url = "https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "ref": "default/claude-code@1.0.0",
  "digest": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "status": "ready",
  "build_time_ms": 118420,
  "job_id": "9f1c2d3e-4b5a-4c6d-8e7f-0a1b2c3d4e5f",
  "phase": "done",
  "attempts": 1,
  "queued_at": "2026-06-08T16:58:00Z",
  "finished_at": "2026-06-08T17:00:02Z"
}

Returns the current build state of a version. Poll this after Build template until status is ready or failed. Reading status is not plan-gated. A curated ref resolves too: pass the system namespace, e.g. system/coding/1.0.3, to read the build state of a curated template.

Path parameters

string

required

Template namespace.

string

required

Template name.

string

required

Version (semver).

Response

string

One of:

not_built: no golden snapshot yet, or the last queued build was cancelled. Call Build template.
building: a build is queued or running.
ready: built and launchable.
failed: the last build failed. See error.

string

Template ref.

string

Content-addressed digest.

integer

Build duration in milliseconds. Present once a queued build has finished.

string

Failure reason. Present when status is failed.

The fields below are present when the version was built through the build queue, which is how Build template builds your own templates. They are absent for curated templates and for versions built before the queue.

string

ID of the newest build job for this version.

string

Job phase. queued while waiting for a runner, retrying while waiting after a failed attempt.

integer

How many times a runner has attempted the job.

string

ISO 8601 timestamp of when the job was queued.

string

ISO 8601 timestamp of when the job finished, or null while it is in flight.

Example

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

import os, requests

r = requests.get(
    "https://www.orgo.ai/api/templates/default/claude-code/1.0.0/build",
    headers={"Authorization": f"Bearer {os.environ['ORGO_API_KEY']}"},
)
print(r.json()["status"])

const r = await fetch(
  "https://www.orgo.ai/api/templates/default/claude-code/1.0.0/build",
  { headers: { Authorization: `Bearer ${process.env.ORGO_API_KEY}` } },
);
console.log((await r.json()).status);

Response

{
  "ref": "default/claude-code@1.0.0",
  "digest": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "status": "ready",
  "build_time_ms": 118420,
  "job_id": "9f1c2d3e-4b5a-4c6d-8e7f-0a1b2c3d4e5f",
  "phase": "done",
  "attempts": 1,
  "queued_at": "2026-06-08T16:58:00Z",
  "finished_at": "2026-06-08T17:00:02Z"
}

Errors

Status	Body	Meaning
`400`	`{ "error": string }`	The path does not form a valid `namespace/name@version` ref. The message starts with `invalid`.
`401`	`{ "error": "Invalid API key" }`	The Bearer token starts with `sk_` but is not a known Orgo key.
`401`	`{ "error": "Authentication required" }`	No `Authorization` header, or a Bearer token that is not an `sk_` key.
`401`	`{ "error": "This endpoint requires an account-wide credential (workspace_scope_mismatch)." }`	The key is workspace-scoped. Template endpoints need an account-wide key. This route answers with `401`, not `403`.
`401`	`{ "error": "Service temporarily unavailable. …" }`	Orgo could not verify the key because of a server-side fault. The key is fine. Retry.
`404`	`{ "error": string }`	No such template version is published, in your namespaces or, for a `system` ref, among curated templates.
`500`	`{ "error": string }`	Unexpected server error (`"internal error"`), or the template registry host failed or timed out. Retry.
`503`	`{ "error": string }`	No fleet host is available to serve the template registry. Retry.

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

Content-addressed digest.

status

enum<string>

not_built: no golden snapshot yet, or the last queued build was cancelled. building: queued or running. ready: launchable. failed: see error.

Available options:

ready,

building,

failed,

not_built

build_time_ms

integer

Build duration in milliseconds. Present once a queued build has finished.

error

string

Failure reason. Present when status is failed.

job_id

string

ID of the newest build job for this version. Present for versions built through the build queue only, as are the fields below.

phase

string

Job phase. queued while waiting for a runner, retrying while waiting after a failed attempt.

attempts

integer

How many times a runner has attempted the job.

queued_at

string<date-time>

finished_at

string<date-time> | null

null while the job is in flight.

Get build status

curl --request GET \
  --url https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/templates/{namespace}/{name}/{version}/build")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "ref": "default/claude-code@1.0.0",
  "digest": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "status": "ready",
  "build_time_ms": 118420,
  "job_id": "9f1c2d3e-4b5a-4c6d-8e7f-0a1b2c3d4e5f",
  "phase": "done",
  "attempts": 1,
  "queued_at": "2026-06-08T16:58:00Z",
  "finished_at": "2026-06-08T17:00:02Z"
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Get build status

Path parameters

Response

Example

Response

Errors

Authorizations

Path Parameters

Response

​Path parameters

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Response

Path parameters

Response

Example

Response

Errors