Orgo - Cloud computers for AI agents

POST

files

export

Export file

curl --request POST \
  --url https://www.orgo.ai/api/files/export \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "desktopId": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "path": "/root/Desktop/results.txt"
}
'

import requests

url = "https://www.orgo.ai/api/files/export"

payload = {
    "desktopId": "a3bb189e-8bf9-3888-9912-ace4e6543002",
    "path": "/root/Desktop/results.txt"
}
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({
    desktopId: 'a3bb189e-8bf9-3888-9912-ace4e6543002',
    path: '/root/Desktop/results.txt'
  })
};

fetch('https://www.orgo.ai/api/files/export', 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/files/export",
  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([
    'desktopId' => 'a3bb189e-8bf9-3888-9912-ace4e6543002',
    'path' => '/root/Desktop/results.txt'
  ]),
  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/files/export"

	payload := strings.NewReader("{\n  \"desktopId\": \"a3bb189e-8bf9-3888-9912-ace4e6543002\",\n  \"path\": \"/root/Desktop/results.txt\"\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/files/export")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"desktopId\": \"a3bb189e-8bf9-3888-9912-ace4e6543002\",\n  \"path\": \"/root/Desktop/results.txt\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/files/export")

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  \"desktopId\": \"a3bb189e-8bf9-3888-9912-ace4e6543002\",\n  \"path\": \"/root/Desktop/results.txt\"\n}"

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

{
  "success": true,
  "file": {
    "id": "f1e2d3c4-0000-4000-8000-000000000001",
    "project_id": "550e8400-e29b-41d4-a716-446655440000",
    "desktop_id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
    "user_id": "a1c2e3f4-1111-4222-8333-444455556666",
    "filename": "results.txt",
    "storage_key": "550e8400-e29b-41d4-a716-446655440000/a3bb189e-8bf9-3888-9912-ace4e6543002/exports/1791882000000-results.txt",
    "size_bytes": "2048",
    "content_type": "text/plain",
    "created_at": "2026-10-13T09:00:00.000Z",
    "source": "export"
  },
  "url": "https://objects.example.com/…"
}

Copies one file off a running computer into workspace storage and returns a download link. The computer sends the file straight to storage, so files up to 2 GB work. The file is recorded in the workspace with source set to export, so it also appears in the list endpoint.

Request

Send a JSON body.

string

required

Computer ID (UUID) to export from. Omitting it returns 400.

string

required

Absolute path to the file on the computer, such as /root/Desktop/results.txt or, on Windows, C:\Users\Public\results.txt. A relative path, or a Linux path on a Windows computer (or the reverse), returns 400. The file must be 2 GB or smaller.

Response

boolean

Always true.

object

The stored file record: id, project_id (the workspace), desktop_id, user_id, filename, storage_key, size_bytes (a decimal string), content_type, created_at and source (export). content_type is guessed from the file’s extension. If the record could not be saved, only filename, size_bytes, content_type and source are returned, and the link still works.

string

Signed download link. It expires after one hour. To get a fresh link later, pass file.id to the download endpoint.

Example

curl -X POST https://www.orgo.ai/api/files/export \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"desktopId\": \"$COMPUTER_ID\", \"path\": \"/root/Desktop/results.txt\"}"

import os
import requests

response = requests.post(
    "https://www.orgo.ai/api/files/export",
    headers={
        "Authorization": f"Bearer {os.environ['ORGO_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "desktopId": os.environ["COMPUTER_ID"],
        "path": "/root/Desktop/results.txt",
    },
)

download_url = response.json()["url"]
with open("results.txt", "wb") as f:
    f.write(requests.get(download_url).content)

const response = await fetch('https://www.orgo.ai/api/files/export', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.ORGO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    desktopId: process.env.COMPUTER_ID,
    path: '/root/Desktop/results.txt',
  }),
});

const { url } = await response.json();
const file = await fetch(url);

Response

{
  "success": true,
  "file": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "project_id": "550e8400-e29b-41d4-a716-446655440000",
    "desktop_id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
    "user_id": "9f8e7d6c-5b4a-3210-fedc-ba9876543210",
    "filename": "results.txt",
    "storage_key": "550e8400-e29b-41d4-a716-446655440000/a3bb189e-8bf9-3888-9912-ace4e6543002/exports/1705314600000-results.txt",
    "size_bytes": "2048",
    "content_type": "text/plain",
    "created_at": "2024-01-15T10:30:00Z",
    "source": "export"
  },
  "url": "https://objects.example.com/…"
}

Errors

Every error carries the shape {"error": "<message>"}. The scope-mismatch 403 adds code, key_workspace_id, and target_workspace_id. The checks below run in order, so the first one that fails is the status you get.

Status	Body	Cause
`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.
`400`	`{"error": "Missing desktopId or path"}`	Either field was absent or empty.
`400`	`{"error": "path must be an absolute path on the computer"}`	`path` is not absolute, contains a null byte, or is longer than 4096 characters. Also returned when the path’s form does not match the computer’s OS.
`404`	`{"error": "Desktop not found"}`	No computer has that ID. A `desktopId` that is not a UUID returns `500` instead.
`403`	`{"error": "Access denied"}`	The caller neither owns the computer’s workspace nor belongs to it, or has view-only access to it.
`402`	`{"error": "Choose a plan to continue."}`	The computer is a free trial computer that can no longer run.
`402`	`{"error": "Manage this computer’s payment in Account → Usage."}`	The computer is paid for by its own subscription or dedicated purchase, and that payment has lapsed.
`403`	`{"error": "…", "code": "workspace_scope_mismatch", "key_workspace_id": "…", "target_workspace_id": "…"}`	A workspace-scoped key named a computer in a different workspace.
`400`	`{"error": "Desktop is not running"}`	The computer’s status is anything other than `running`.
`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 }`	Your account’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.
`503`	`{"error": "Computer not ready"}`	The computer has no connection details recorded, so it cannot be addressed.
`404`	`{"error": "No file at /root/Desktop/results.txt"}`	Nothing at that path is a regular file. A folder returns this too.
`413`	`{"error": "File is 3221225472 bytes; the limit is 2147483648. Split or compress it first."}`	The file is larger than 2 GB.
`502`	`{"error": "Could not copy results.txt off the computer."}`	The computer could not be reached, or did not confirm it had sent the file within about 90 seconds.
`500`	`{"error": "Export failed"}`	Unexpected failure.

Authorizations

Authorization

string

header

required

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

Body

application/json

desktopId

string

required

Computer ID

path

string

required

Absolute path of the file on the computer, such as /root/Desktop/results.txt or C:\Users\Public\results.txt.

Response

The file was copied. url downloads it for one hour.

success

boolean

file

object

Show child attributes

url

string

Signed download URL. Works for one hour.

Export file

curl --request POST \
  --url https://www.orgo.ai/api/files/export \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "desktopId": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "path": "/root/Desktop/results.txt"
}
'

import requests

url = "https://www.orgo.ai/api/files/export"

payload = {
    "desktopId": "a3bb189e-8bf9-3888-9912-ace4e6543002",
    "path": "/root/Desktop/results.txt"
}
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({
    desktopId: 'a3bb189e-8bf9-3888-9912-ace4e6543002',
    path: '/root/Desktop/results.txt'
  })
};

fetch('https://www.orgo.ai/api/files/export', 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/files/export",
  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([
    'desktopId' => 'a3bb189e-8bf9-3888-9912-ace4e6543002',
    'path' => '/root/Desktop/results.txt'
  ]),
  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/files/export"

	payload := strings.NewReader("{\n  \"desktopId\": \"a3bb189e-8bf9-3888-9912-ace4e6543002\",\n  \"path\": \"/root/Desktop/results.txt\"\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/files/export")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"desktopId\": \"a3bb189e-8bf9-3888-9912-ace4e6543002\",\n  \"path\": \"/root/Desktop/results.txt\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/files/export")

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  \"desktopId\": \"a3bb189e-8bf9-3888-9912-ace4e6543002\",\n  \"path\": \"/root/Desktop/results.txt\"\n}"

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

{
  "success": true,
  "file": {
    "id": "f1e2d3c4-0000-4000-8000-000000000001",
    "project_id": "550e8400-e29b-41d4-a716-446655440000",
    "desktop_id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
    "user_id": "a1c2e3f4-1111-4222-8333-444455556666",
    "filename": "results.txt",
    "storage_key": "550e8400-e29b-41d4-a716-446655440000/a3bb189e-8bf9-3888-9912-ace4e6543002/exports/1791882000000-results.txt",
    "size_bytes": "2048",
    "content_type": "text/plain",
    "created_at": "2026-10-13T09:00:00.000Z",
    "source": "export"
  },
  "url": "https://objects.example.com/…"
}

Overview

API keys

Support

Account

Agent accounts

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Export file

Request

Response

Example

Response

Errors

Authorizations

Body

Response

​Request

​Response

​Example

​Response

​Errors

Authorizations

Body

Response

Request

Response

Example

Response

Errors