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, signed in or with a key for the whole account. An invited member gets 403, described in Errors. A workspace key can’t delete a workspace, even its own, whatever its permissions. The verb is POST and the path ends in /delete. DELETE /workspaces/{id} does the same, with the same answers.

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.
`403`	`{ "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 `403`, not `404`.
`403`	`{ "error": "This workspace is view-only. Ask the owner for write access (workspace_read_only).", "code": "workspace_read_only" }`	You are a view-only member of the workspace.
`403`	`{ "error": "Workspace-scoped keys cannot manage people or delete a workspace. Use an account-wide key or sign in (workspace_scope_mismatch).", "code": "workspace_scope_mismatch" }`	A workspace-scoped key, for its own workspace or another.
`403`	`{ "error": "…", "code": "key_permission" }`	A restricted key without Workspaces write.
`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": "…", "code": "suspend_in_progress" }`	A computer in the workspace is still being saved to storage. Retry once it shows `suspended`. Nothing was deleted.
`409`	`{ "error": "…", "code": "resume_in_progress" }`	A computer in the workspace is resuming from storage. Retry once it is running. Nothing was deleted.
`409`	`{ "error": "…", "code": "evict_in_progress", "retry_after": 120 }`	A computer in the workspace is still being moved off its host to storage. Retry after `retry_after` seconds, also sent as `Retry-After`. Nothing was deleted.
`409`	`{ "error": "…", "code": "computer_waking", "retry_after": 30 }`	A computer in the workspace is waking from storage or being moved to it. Retry after `retry_after` seconds, also sent as `Retry-After`. Nothing was deleted.
`409`	`{ "error": "…", "code": "migrating" }`	A computer in the workspace is being moved to another host. Retry in a few minutes. 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.
`429`	`{ "error": "Too many API requests this minute (600 a minute on your plan). Try again in 30 seconds.", "code": "rate_limited", "limit": "api_other_per_minute", "retry_after": 30 }`	The workspace owner’s plan rate limit for other API calls. `limit` is `api_other_per_minute`. Carries a `Retry-After` header with the seconds to wait. Refused before the request runs. See Plan rate limits.
`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.

A valid key that lacks access gets 403, as listed above. A server-side fault while verifying the credential answers 503 with Service temporarily unavailable. … as the message and Retry-After: 5. 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

API keys

Support

Account

Agent accounts

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