Orgo - Cloud computers for AI agents

GET

files

download

Download file

curl --request GET \
  --url https://www.orgo.ai/api/files/download \
  --header 'Authorization: Bearer <token>'

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

fetch('https://www.orgo.ai/api/files/download', 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/download",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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/files/download"

	req, _ := http.NewRequest("GET", 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/files/download")

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

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

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

{
  "url": "<string>"
}

Returns a signed URL for a file stored in a workspace. The endpoint returns the URL, not the bytes. Fetch the URL to get the file.

Query parameters

string

required

File ID, as returned by the list or upload endpoints. Omitting it returns 400.

Response

string

Signed download URL, valid for one hour from the moment of the request. It carries the file’s original name as an attachment filename. A browser saves it under that name rather than under the internal storage key.

Example

curl "https://www.orgo.ai/api/files/download?id=$FILE_ID" \
  -H "Authorization: Bearer $ORGO_API_KEY"

import os
import requests

response = requests.get(
    "https://www.orgo.ai/api/files/download",
    headers={"Authorization": f"Bearer {os.environ['ORGO_API_KEY']}"},
    params={"id": file_id},
)

url = response.json()["url"]

# Fetch the file itself
file_response = requests.get(url)
with open("downloaded.txt", "wb") as f:
    f.write(file_response.content)

const response = await fetch(
  `https://www.orgo.ai/api/files/download?id=${fileId}`,
  { headers: { Authorization: `Bearer ${process.env.ORGO_API_KEY}` } },
);

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

// Fetch the file itself
const fileResponse = await fetch(url);
const blob = await fileResponse.blob();

Response

{
  "url": "https://objects.us-east-2.storage.sh/…"
}

The URL is pre-signed. It works in a browser or any HTTP client with no authorization header of its own, and it expires one hour after it is issued. Request a new one rather than storing it.

Errors

Every error carries the shape {"error": "<message>"}.

Status	Body	Cause
`400`	`{"error": "Missing file id"}`	The `id` query parameter was absent.
`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.
`404`	`{"error": "File not found"}`	No file has that ID.
`403`	`{"error": "Access denied"}`	The file exists, but the caller neither owns its workspace nor belongs to it.
`500`	`{"error": "Download failed"}`	The URL could not be signed. The message may instead carry the underlying error.

Authorizations

Authorization

string

header

required

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

Query Parameters

string

required

File ID, from GET /files. Required; omitting it is a 400.

Response

Download URL

url

string

Signed download URL (expires in 1 hour)

Download file

curl --request GET \
  --url https://www.orgo.ai/api/files/download \
  --header 'Authorization: Bearer <token>'

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

fetch('https://www.orgo.ai/api/files/download', 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/download",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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/files/download"

	req, _ := http.NewRequest("GET", 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/files/download")

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

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

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

{
  "url": "<string>"
}

Overview

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Download file

Query parameters

Response

Example

Response

Errors

Authorizations

Query Parameters

Response

​Query parameters

​Response

​Example

​Response

​Errors

Authorizations

Query Parameters

Response

Query parameters

Response

Example

Response

Errors