Orgo - Cloud computers for AI agents

DELETE

templates

{namespace}

{name}

{version}

Delete template version

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

import requests

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

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

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

print(response.text)

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

fetch('https://www.orgo.ai/api/templates/{namespace}/{name}/{version}', 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}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  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}"

	req, _ := http.NewRequest("DELETE", 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}")

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

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

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

{
  "deleted": true,
  "cancelledJobs": 0
}

Deletes a single published version you own: its registry entry, its golden snapshot, and any of its builds still waiting in the queue. To replace a version in place instead of deleting it, re-publish with ?force=true. The call is idempotent. Deleting a version that is already gone, or never existed, returns 200 with deleted: true.

Deleting a version that computers were launched from does not affect those running computers. They already started from the golden snapshot. The delete removes the version from your registry, so it can no longer be launched or built. It is scoped to your own templates, so a curated (system/…) ref removes nothing, even though the response still reads deleted: true.

Path parameters

string

required

Template namespace.

string

required

Template name.

string

required

Version (semver) to delete.

Response

boolean

Always true on success, including when the version was already gone. A failure comes back as a 4xx or 5xx instead.

integer

How many of the version’s queued builds were cancelled. A build a runner had already claimed is not counted.

Example

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

import os, requests

r = requests.delete(
    "https://www.orgo.ai/api/templates/default/claude-code/1.0.0",
    headers={"Authorization": f"Bearer {os.environ['ORGO_API_KEY']}"},
)
print(r.json())  # {"deleted": true, "cancelledJobs": 0}

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

Response

{ "deleted": true, "cancelledJobs": 0 }

Errors

Status	Body	Meaning
`400`	`{ "error": string }`	A path segment is not a valid template namespace, name, or version, e.g. `"invalid template reference"`.
`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.
`500`	`{ "error": string }`	Unexpected server error (`"internal error"`), or the template registry host failed or timed out. Retry; the delete is idempotent.
`502`	`{ "error": "golden objects could not be scheduled for deletion", "code": "golden_delete_incomplete" }`	The version still exists. Retry.
`503`	`{ "error": "template authority unavailable", "code": "delete_authority_unavailable" }`	The template record could not be read or written. The version still exists. 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

Deleted, or already gone

deleted

enum<boolean>

Available options:

true

cancelledJobs

integer

How many of the version's queued builds were cancelled. A build a runner had already claimed is not counted.

Delete template version

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

import requests

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

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

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

print(response.text)

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

fetch('https://www.orgo.ai/api/templates/{namespace}/{name}/{version}', 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}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  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}"

	req, _ := http.NewRequest("DELETE", 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}")

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

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

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

{
  "deleted": true,
  "cancelledJobs": 0
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Delete template version

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