Orgo - Cloud computers for AI agents

POST

computers

{id}

secrets

sync

Apply secrets to a computer

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/secrets/sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "names": [
    "ANTHROPIC_API_KEY"
  ]
}
'

import requests

url = "https://www.orgo.ai/api/computers/{id}/secrets/sync"

payload = { "names": ["ANTHROPIC_API_KEY"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({names: ['ANTHROPIC_API_KEY']})
};

fetch('https://www.orgo.ai/api/computers/{id}/secrets/sync', 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/computers/{id}/secrets/sync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'names' => [
        'ANTHROPIC_API_KEY'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://www.orgo.ai/api/computers/{id}/secrets/sync"

	payload := strings.NewReader("{\n  \"names\": [\n    \"ANTHROPIC_API_KEY\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/computers/{id}/secrets/sync")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"names\": [\n    \"ANTHROPIC_API_KEY\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/secrets/sync")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"names\": [\n    \"ANTHROPIC_API_KEY\"\n  ]\n}"

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

{
  "success": true,
  "names": [
    "<string>"
  ],
  "restart_required": true,
  "message": "<string>"
}

Send {"names":["ANTHROPIC_API_KEY"]} to apply those names from your vault to a running Linux computer. names takes 1 to 50 environment variable names made of letters, digits, and underscores, not starting with a digit, up to 64 characters each. Duplicates are ignored. Workspace values take precedence over account values. This requires write access to the computer’s workspace. The response contains success, names, restart_required: true, and a message. The values are written to /root/.orgo-secrets.env, which /root/.env, .bashrc, and .profile load. Open a new terminal or restart the agent to load the updated environment. Existing processes keep their current environment. Applications using their own credential files may need to be configured separately. An invalid names list returns 400. A missing secret returns 404 with { "error": "A requested secret is not available in your vault for this workspace." }. A computer that is not running returns 409; a different operating system returns 422. A failure to write the values on the computer returns 502 with { "error": "Could not apply secrets. Check the computer connection and try again." }. A missing or invalid API key returns 401. An unknown computer returns 404 with { "error": "Desktop not found" }. No access to the computer’s workspace, view-only access, or an API key scoped to another workspace returns 403. A trial computer whose trial has ended returns 402 with { "error": "Choose a plan to continue." }. If Orgo cannot verify the credential because of a server-side fault, such as a database outage, the request returns 503 with { "error": "Service temporarily unavailable. …" } and Retry-After: 5. Retry after that delay; do not rotate the key. Secret values are never included in the response. Saving or deleting a vault entry does not automatically change computers already running. Deleting a vault entry also does not erase a copy previously installed on a computer.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Computer UUID or instance ID.

Body

application/json

names

string[]

required

Required array length: 1 - 50 elements

An environment variable name: letters, digits, and underscores, not starting with a digit, up to 64 characters.

Pattern: ^[A-Za-z_][A-Za-z0-9_]{0,63}$

Response

Secrets applied to a running Linux computer. Open a new terminal or restart its agent to read the new environment. Values are never returned.

success

boolean

names

string[]

restart_required

boolean

message

string

Apply secrets to a computer

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/secrets/sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "names": [
    "ANTHROPIC_API_KEY"
  ]
}
'

import requests

url = "https://www.orgo.ai/api/computers/{id}/secrets/sync"

payload = { "names": ["ANTHROPIC_API_KEY"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({names: ['ANTHROPIC_API_KEY']})
};

fetch('https://www.orgo.ai/api/computers/{id}/secrets/sync', 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/computers/{id}/secrets/sync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'names' => [
        'ANTHROPIC_API_KEY'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://www.orgo.ai/api/computers/{id}/secrets/sync"

	payload := strings.NewReader("{\n  \"names\": [\n    \"ANTHROPIC_API_KEY\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/computers/{id}/secrets/sync")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"names\": [\n    \"ANTHROPIC_API_KEY\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/secrets/sync")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"names\": [\n    \"ANTHROPIC_API_KEY\"\n  ]\n}"

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

{
  "success": true,
  "names": [
    "<string>"
  ],
  "restart_required": true,
  "message": "<string>"
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Apply secrets

Authorizations

Path Parameters

Body

Response