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": os.environ["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=${process.env.FILE_ID}`,
  { 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.
`400`	`{"error": "id and fileId must identify the same file"}`	Both `id` and `fileId` were sent with different values.
`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.
`401`	`{"error": "You do not have access to this workspace."}`	The file exists, but the caller neither owns its workspace nor belongs to it.
`401`	`{"error": "This API key cannot access this workspace (workspace_scope_mismatch)."}`	A workspace-scoped key asked for a file in a different workspace.
`401`	`{"error": "Service temporarily unavailable. …"}`	Orgo could not verify the credential because of a server-side fault. Retry.
`404`	`{"error": "File not found"}`	No file has that ID.
`500`	`{"error": "Download failed"}`	The URL could not be signed, or the `id` is not a UUID. The message may instead carry the underlying error.

Compatibility parameter

Prefer id. The older fileId spelling is also accepted as an alias. If both are present with different values the request returns 400. At least one is required.

Authorizations

Authorization

string

header

required

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

Query Parameters

string

File ID. Supply id or its compatibility alias fileId. If both are supplied they must match.

fileId

string

Compatibility alias for id. Prefer id.

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

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Download file

Query parameters

Response

Example

Response

Errors

Compatibility parameter

Authorizations

Query Parameters

Response

​Query parameters

​Response

​Example

​Response

​Errors

​Compatibility parameter

Authorizations

Query Parameters

Response

Query parameters

Response

Example

Response

Errors

Compatibility parameter