Orgo - Cloud computers for AI agents

POST

workspaces

{id}

delete

Delete workspace

curl --request POST \
  --url https://www.orgo.ai/api/workspaces/{id}/delete \
  --header 'Authorization: Bearer <token>'

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

fetch('https://www.orgo.ai/api/workspaces/{id}/delete', 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/workspaces/{id}/delete",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/workspaces/{id}/delete"

	req, _ := http.NewRequest("POST", 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/workspaces/{id}/delete")

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

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

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

{
  "success": true,
  "message": "Project deleted successfully"
}

Deletes a workspace and every computer in it. Only the workspace owner can call this. An invited member gets 401 or 403, described in Errors. The verb is POST and the path ends in /delete. There is no DELETE handler on /workspaces/{id}. Sending DELETE there returns 405.

This cannot be undone. Every computer in the workspace is terminated and its disk destroyed.

Order of operations

The endpoint runs these steps in this order:

Checks that you own the workspace.
Refuses with 409, before touching anything, when the workspace holds a device or dedicated machine that Orgo manages, has a dedicated computer purchase, has hourly or dedicated computer billing records, has an OpenClaw enrollment, or when another operation is already working on it.
Terminates each computer on its host, one at a time. A host that answers 404, or a computer with no recorded host address, does not stop the delete. A failed termination does not stop the loop either: every remaining computer is still tried.
Returns 500 if any termination failed. The workspace, its file records, and the computers that were not terminated stay in place.
Deletes the workspace’s file records and the workspace row together. The database cascade then removes the computer records.

A 500 does not mean the workspace is intact. Every computer whose termination succeeded is already destroyed, including any after the one that failed. A retry does not re-send the failed terminations. It returns 409 with teardown_reconciliation_required until Orgo support confirms what happened to them. Contact support to finish the delete.

Path parameters

string

required

Workspace ID. Required.

The request body is ignored.

Response

boolean

true when the workspace and all of its computers were deleted. The endpoint never returns false. A failure comes back as a 4xx or 5xx instead.

string

Human-readable confirmation. Currently "Project deleted successfully".

Example

curl -X POST https://www.orgo.ai/api/workspaces/$WORKSPACE_ID/delete \
  -H "Authorization: Bearer $ORGO_API_KEY"

import os
import requests

api_key = os.environ["ORGO_API_KEY"]
workspace_id = os.environ["WORKSPACE_ID"]

response = requests.post(
    f"https://www.orgo.ai/api/workspaces/{workspace_id}/delete",
    headers={"Authorization": f"Bearer {api_key}"}
)

if response.json().get("success"):
    print("Workspace deleted")

const apiKey = process.env.ORGO_API_KEY;
const workspaceId = process.env.WORKSPACE_ID;

const response = await fetch(
  `https://www.orgo.ai/api/workspaces/${workspaceId}/delete`,
  {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${apiKey}` }
  }
);

const { success } = await response.json();
if (success) console.log('Workspace deleted');

Response

{
  "success": true,
  "message": "Project deleted successfully"
}

Errors

Status	Body	Meaning
`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": "You do not have access to this workspace." }`	Your account neither owns nor belongs to the workspace, or no workspace has that ID. An unknown ID returns this `401`, not `404`.
`401`	`{ "error": "This workspace is view-only. Ask the owner for write access (workspace_read_only)." }`	You are a view-only member of the workspace.
`401`	`{ "error": "This API key cannot access this workspace (workspace_scope_mismatch)." }`	A workspace-scoped key targeted a different workspace.
`403`	`{ "error": "Only project owner can delete project" }`	You are a member with edit access, not the owner.
`409`	`{ "error": "workspace_holds_device", "message": "…" }`	The workspace holds a Mac, an iPhone, or a dedicated machine that Orgo manages. Ask support to release it first. Nothing was deleted.
`409`	`{ "error": "compute_allocation_active", "detail": "…" }`	The workspace has a dedicated computer purchase on record. Manage it in Account → Usage first. Nothing was deleted.
`409`	`{ "error": "compute_billing_records", "detail": "…" }`	The workspace has hourly or dedicated computer billing records that Orgo keeps. Contact support to delete it. Nothing was deleted, unless the records appeared while the delete was running: then the computers it already shut down stay shut down.
`409`	`{ "error": "openclaw_enrollment_cleanup_required", "detail": "…" }`	The workspace has an OpenClaw enrollment. Revoke it first. Nothing was deleted.
`409`	`{ "error": "teardown_in_flight", "detail": "…" }`	Another operation is already working on this workspace. Retry in a moment.
`409`	`{ "error": "teardown_unavailable", "detail": "…" }`	The delete could not start right now. Retry in a moment.
`409`	`{ "error": "teardown_membership_changed", "detail": "…" }`	A computer was added to the workspace while it was being deleted. Remove it, then retry.
`409`	`{ "error": "teardown_reconciliation_required", "detail": "…" }`	An earlier attempt could not confirm that every computer shut down. Support has to reconcile it before the delete can finish.
`500`	`{ "error": "Refusing to delete project. …" }`	One or more computers could not be terminated, so the workspace was not deleted. Deletion is already partly done: every computer whose termination succeeded is destroyed. See Order of operations.
`500`	`{ "error": "Failed to delete workspace" }`	Unexpected server error.

This endpoint answers every failed authorization check with 401, including a valid key that lacks access. A server-side fault while verifying the credential also comes back as 401, with Service temporarily unavailable. … as the message. Retry that one.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Workspace ID

Response

Workspace deleted

success

boolean

Example:

true

message

string

Human-readable confirmation.

Example:

"Project deleted successfully"

Delete workspace

curl --request POST \
  --url https://www.orgo.ai/api/workspaces/{id}/delete \
  --header 'Authorization: Bearer <token>'

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

fetch('https://www.orgo.ai/api/workspaces/{id}/delete', 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/workspaces/{id}/delete",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/workspaces/{id}/delete"

	req, _ := http.NewRequest("POST", 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/workspaces/{id}/delete")

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

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

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

{
  "success": true,
  "message": "Project deleted successfully"
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Delete workspace

Order of operations

Path parameters

Response

Example

Response

Errors

Authorizations

Path Parameters

Response

​Order of operations

​Path parameters

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Response

Order of operations

Path parameters

Response

Example

Response

Errors