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
}

Deletes a workspace and every computer in it. Only the workspace owner can call this. An invited member gets 403. 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 is not a transaction. It runs these steps in this order:

Checks that you own the workspace. A member gets 403, and an unknown workspace gets 404.
Deletes the workspace’s file records. This is permanent, and it happens before any computer is touched.
Terminates each computer on its host, one at a time. A host that answers 404 counts as already gone. A computer with no recorded host address is skipped.
Stops and returns 500 if any termination failed. The workspace row and its computers stay in place.
Deletes the workspace row. The database cascade then removes the computer records.

A 500 does not mean the workspace is intact. By the time it is returned, the file records are already deleted, and every computer terminated before the failing one is already destroyed. What survives is the workspace row and the computers that were not reached. Retrying is safe, and it finishes the delete once every computer terminates. Nothing brings the file records back.

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": "This API key is scoped to workspace …", "code": "workspace_scope_mismatch", "key_workspace_id": "…", "target_workspace_id": "…" }`	A workspace-scoped key targeted a different workspace. This is one of the few endpoints where key scope is enforced.
`403`	`{ "error": "Only project owner can delete project" }`	You are a member of the workspace, not its owner.
`404`	`{ "error": "Project not found" }`	No workspace with that ID.
`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: the file records are gone and any computer terminated before the failure is destroyed. Retry once the computers are reachable again. See Order of operations.
`500`	`{ "error": "<message>" }`	Unexpected server error.

The scope check runs before the workspace lookup, so a workspace-scoped key targeting an ID that does not exist gets 403, not 404.

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

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
}

Overview

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