unsandbox.com

Anonymous remote code, compile, & execution API for humans & machine learning agents.

Docs 📚 View Pricing →
unsandbox.
Select Language
Bash C C++ C# Clojure Common Lisp COBOL Crystal D Dart Deno Elixir Erlang Forth Fortran F# Go Groovy Haskell Idris2 Java JavaScript Julia Kotlin Lua Nim Objective-C OCaml Pascal Perl PHP Prolog Python R Raku Ruby Rust Scheme Tcl TypeScript V Zig
unsandbox.
Required Dependencies

The JavaScript examples below require the following 3rd party libraries:

  • axios

Make sure these packages are installed in your environment before running the examples.

unsandbox.
POST https://api.unsandbox.com/execute

Execute code immediately and wait for results. Best for quick scripts and interactive use.

Request Parameters

Parameter Type Required Description
language string ✓ Programming language
code string ✓ Source code to execute
env object Environment variables (key-value pairs)
network_mode string "zerotrust" or "semitrusted"
ttl integer Timeout 1-900s (default: 60)
return_artifact boolean Return compiled binary
return_wasm_artifact boolean Return WebAssembly binary
input_files array Files to upload (see Input Files)

Example (JavaScript)

const https = require("https");

const payload = JSON.stringify({
  language: "python",
  code: "print('Hello from unsandbox!')",
});

const options = {
  hostname: "api.unsandbox.com",
  port: 443,
  path: "/execute",
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
    "Content-Length": payload.length,
  },
};

const req = https.request(options, (res) => {
  let data = "";
  res.on("data", (chunk) => {
    data += chunk;
  });
  res.on("end", () => {
    const result = JSON.parse(data);
    if (result.success) {
      console.log("Output:", result.stdout);
    } else {
      console.log("Error:", result.stderr);
    }
  });
});

req.on("error", (error) => console.error("Request failed:", error));
req.write(payload);
req.end();

Response (Success)

{
  "success": true,
  "stdout": "Hello from unsandbox!\n",
  "stderr": "",
  "exit_code": 0,
  "language": "python",
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "artifacts": [],
  "execution_mode": "pooled",
  "network_mode": "zerotrust",
  "total_time_ms": 523
}

Response (Error)

{
  "success": false,
  "stdout": "",
  "stderr": "SyntaxError: invalid syntax\n",
  "exit_code": 1,
  "language": "python",
  "job_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "artifacts": [],
  "execution_mode": "pooled",
  "network_mode": "zerotrust",
  "total_time_ms": 312
}
unsandbox.
POST https://api.unsandbox.com/execute/async

Submit code for execution and receive a job ID to poll for results. Best for long-running scripts or when you need to decouple submission from execution.

Request Parameters

Parameter Type Required Description
language string ✓ Programming language
code string ✓ Source code to execute
env object Environment variables (key-value pairs)
network_mode string "zerotrust" or "semitrusted"
ttl integer Timeout 1-900s (default: 60)
return_artifact boolean Return compiled binary
return_wasm_artifact boolean Return WebAssembly binary
input_files array Files to upload (see Input Files)

Example (JavaScript)

const https = require("https");

function makeRequest(options, postData = null) {
  return new Promise((resolve, reject) => {
    const req = https.request(options, (res) => {
      let data = "";
      res.on("data", (chunk) => {
        data += chunk;
      });
      res.on("end", () => resolve(JSON.parse(data)));
    });
    req.on("error", reject);
    if (postData) req.write(postData);
    req.end();
  });
}

async function main() {
  const payload = JSON.stringify({
    language: "rust",
    code: 'fn main() { println!("Computing..."); }',
    ttl: 300,
  });

  // Submit job
  const submitOptions = {
    hostname: "api.unsandbox.com",
    port: 443,
    path: "/execute/async",
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
      "Content-Length": payload.length,
    },
  };

  const submitResponse = await makeRequest(submitOptions, payload);
  const jobId = submitResponse.job_id;
  console.log(`Job submitted: ${jobId}`);

  // Poll for results
  const statusOptions = {
    hostname: "api.unsandbox.com",
    port: 443,
    path: `/jobs/${jobId}`,
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
    },
  };

  while (true) {
    const status = await makeRequest(statusOptions);

    if (status.status === "completed") {
      if (status.success) {
        console.log("Output:", status.stdout);
      } else {
        console.log("Error:", status.stderr);
      }
      break;
    } else if (["timeout", "cancelled"].includes(status.status)) {
      console.log(`Job ${status.status}`);
      break;
    }

    await new Promise((resolve) => setTimeout(resolve, 1000));
  }
}

main().catch((error) => console.error("Request failed:", error));

Initial Response

{
  "job_id": "job_1234567890_abc",
  "status": "pending"
}
unsandbox.
GET https://api.unsandbox.com/jobs/{id}

Check the status and results of an asynchronous job. Poll this endpoint after submitting a job via /execute/async or /run/async.

URL Parameters

Parameter Type Description
id string Job ID returned from async endpoint

Example (JavaScript)

const https = require("https");

const jobId = "job_1234567890_abc";

const options = {
  hostname: "api.unsandbox.com",
  port: 443,
  path: `/jobs/${jobId}`,
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
  },
};

const req = https.request(options, (res) => {
  let data = "";
  res.on("data", (chunk) => {
    data += chunk;
  });
  res.on("end", () => {
    const job = JSON.parse(data);
    console.log(`Status: ${job.status}`);
    if (job.status === "completed") {
      console.log(`Exit Code: ${job.result.exit_code}`);
      console.log(`Output: ${job.stdout}`);
    }
  });
});

req.on("error", (error) => console.error("Request failed:", error));
req.end();

Response (Completed)

{
  "job_id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "status": "completed",
  "created_at": 1699564800,
  "started_at": 1699564801,
  "completed_at": 1699564805,
  "result": {
    "success": true,
    "stdout": "Hello from unsandbox!\n",
    "stderr": "",
    "exit_code": 0,
    "language": "python",
    "artifacts": [],
    "execution_mode": "pooled",
    "network_mode": "zerotrust",
    "total_time_ms": 4021
  }
}

Possible Status Values

  • pending - Job queued, waiting to execute
  • running - Job currently executing
  • completed - Job finished (check result field)
  • timeout - Job exceeded TTL limit
  • cancelled - Job was cancelled via DELETE
unsandbox.
GET https://api.unsandbox.com/jobs

List all active (pending or running) jobs for your API key. Useful for monitoring multiple async executions.

Example (JavaScript)

const https = require("https");

const options = {
  hostname: "api.unsandbox.com",
  port: 443,
  path: "/jobs",
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
  },
};

const req = https.request(options, (res) => {
  let data = "";
  res.on("data", (chunk) => {
    data += chunk;
  });
  res.on("end", () => {
    const jobs = JSON.parse(data);
    jobs.forEach((job) => {
      console.log(`${job.job_id}: ${job.status} (${job.language})`);
    });
  });
});

req.on("error", (error) => console.error("Request failed:", error));
req.end();

Response

{
  "jobs": [
    {
      "job_id": "job_1234567890_abc",
      "status": "running",
      "language": "python",
      "submitted_at": "2024-01-15T10:30:00Z"
    },
    {
      "job_id": "job_0987654321_xyz",
      "status": "pending",
      "language": "go",
      "submitted_at": "2024-01-15T10:29:45Z"
    }
  ]
}
unsandbox.
DELETE https://api.unsandbox.com/jobs/{id}

Cancel a pending or running job. If the job is already executing, it will be terminated and partial output returned.

URL Parameters

Parameter Type Description
id string Job ID to cancel

Example (JavaScript)

const https = require("https");

const jobId = "job_1234567890_abc";

const options = {
  hostname: "api.unsandbox.com",
  port: 443,
  path: `/jobs/${jobId}`,
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
  },
};

const req = https.request(options, (res) => {
  let data = "";
  res.on("data", (chunk) => {
    data += chunk;
  });
  res.on("end", () => {
    const result = JSON.parse(data);
    console.log(`Cancelled: ${result.message}`);
    if (result.stdout) {
      console.log(`Partial output: ${result.stdout}`);
    }
  });
});

req.on("error", (error) => console.error("Request failed:", error));
req.end();

Response

{
  "message": "Job cancelled",
  "job_id": "e5f6a7b8-c9d0-1234-efgh-567890123456",
  "result": {
    "success": false,
    "stdout": "Partial output before cancel...",
    "stderr": "",
    "exit_code": -1,
    "language": "python",
    "artifacts": [],
    "execution_mode": "pooled",
    "network_mode": "zerotrust",
    "total_time_ms": 1523
  }
}
unsandbox.
POST https://api.unsandbox.com/run

Execute code with automatic language detection via shebang. Send raw code as the request body with Content-Type: text/plain.

Request

  • Content-Type: text/plain
  • Body: Raw code with shebang (e.g., #!/usr/bin/env python3)

Query Parameters

Parameter Type Required Description
env string URL-encoded JSON object with environment variables
network_mode string "zerotrust" or "semitrusted"
ttl integer Timeout 1-900s (default: 60)
return_artifact boolean Return compiled binary
return_wasm_artifact boolean Return WebAssembly binary

Example (JavaScript)

const https = require("https");

const code = `#!/usr/bin/env python3
print("Language auto-detected!")`;

const options = {
  hostname: "api.unsandbox.com",
  port: 443,
  path: "/run",
  method: "POST",
  headers: {
    "Content-Type": "text/plain",
    Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
    "Content-Length": code.length,
  },
};

const req = https.request(options, (res) => {
  let data = "";
  res.on("data", (chunk) => {
    data += chunk;
  });
  res.on("end", () => {
    const result = JSON.parse(data);
    console.log(`Detected: ${result.detected_language}`);
    console.log(`Output: ${result.stdout}`);
  });
});

req.on("error", (error) => console.error("Request failed:", error));
req.write(code);
req.end();

Response

{
  "success": true,
  "stdout": "Language auto-detected!\n",
  "stderr": "",
  "exit_code": 0,
  "language": "python",
  "detected_language": "python",
  "job_id": "f6a7b8c9-d0e1-2345-fghi-678901234567",
  "artifacts": [],
  "execution_mode": "pooled",
  "network_mode": "zerotrust",
  "total_time_ms": 412
}
unsandbox.
POST https://api.unsandbox.com/run/async

Submit code with automatic language detection and receive a job ID. Combines the convenience of /run with the flexibility of async execution.

Request

  • Content-Type: text/plain
  • Body: Raw code with shebang (e.g., #!/usr/bin/env ruby)

Query Parameters

Parameter Type Required Description
env string URL-encoded JSON object with environment variables
network_mode string "zerotrust" or "semitrusted"
ttl integer Timeout 1-900s (default: 60)
return_artifact boolean Return compiled binary
return_wasm_artifact boolean Return WebAssembly binary

Example (JavaScript)

const https = require("https");

function makeRequest(options, postData = null) {
  return new Promise((resolve, reject) => {
    const req = https.request(options, (res) => {
      let data = "";
      res.on("data", (chunk) => {
        data += chunk;
      });
      res.on("end", () => resolve(JSON.parse(data)));
    });
    req.on("error", reject);
    if (postData) req.write(postData);
    req.end();
  });
}

async function main() {
  const code = `#!/usr/bin/env ruby
puts "Running async with auto-detect!"`;

  // Submit job
  const submitOptions = {
    hostname: "api.unsandbox.com",
    port: 443,
    path: "/run/async",
    method: "POST",
    headers: {
      "Content-Type": "text/plain",
      Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
      "Content-Length": code.length,
    },
  };

  const submitResponse = await makeRequest(submitOptions, code);
  const jobId = submitResponse.job_id;
  console.log(`Job submitted: ${jobId}`);

  // Poll for results
  const statusOptions = {
    hostname: "api.unsandbox.com",
    port: 443,
    path: `/jobs/${jobId}`,
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
    },
  };

  while (true) {
    const status = await makeRequest(statusOptions);

    if (status.status === "completed") {
      const result = status.result;
      console.log(`Detected: ${result.detected_language}`);
      if (result.success) {
        console.log(`Output: ${result.stdout}`);
      }
      break;
    } else if (["timeout", "cancelled"].includes(status.status)) {
      console.log(`Job ${status.status}`);
      break;
    }

    await new Promise((resolve) => setTimeout(resolve, 1000));
  }
}

main().catch((error) => console.error("Request failed:", error));

Initial Response

{
  "job_id": "job_1234567890_abc",
  "status": "pending"
}

Job Result (via GET /jobs/{id})

{
  "job_id": "a7b8c9d0-e1f2-3456-ghij-789012345678",
  "status": "completed",
  "created_at": 1699564800,
  "started_at": 1699564801,
  "completed_at": 1699564802,
  "result": {
    "success": true,
    "stdout": "Running async with auto-detect!\n",
    "stderr": "",
    "exit_code": 0,
    "language": "ruby",
    "detected_language": "ruby",
    "artifacts": [],
    "execution_mode": "pooled",
    "network_mode": "zerotrust",
    "total_time_ms": 1234
  }
}
unsandbox.
Input Files

Upload files to your sandbox execution. Files are written to the working directory and can be accessed directly by filename.

File Object Schema

Field Type Required Description
filename string Filename (e.g., "data.csv"). If omitted, file is named by index: "0", "1", etc.
content string ✓ Base64-encoded file content

Example Request

{
  "language": "python",
  "code": "print(open('data.csv').read())",
  "input_files": [
    {
      "filename": "data.csv",
      "content": "bmFtZSxhZ2UKQWxpY2UsMzAKQm9iLDI1"
    }
  ]
}

Limits

  • Maximum files: 10 files per execution
  • Maximum total size: 10MB (decoded)
  • Maximum single file: 5MB (decoded)
  • Filename length: 256 characters max

File Access

Files are placed in the working directory. Access them directly:

  • Python: open('data.csv')
  • Node.js: fs.readFileSync('data.csv')
  • Ruby: File.read('data.csv')
  • Go: os.ReadFile("data.csv")

Security

  • Files are isolated per execution
  • Filenames cannot contain path separators (no / or ..)
  • Files are deleted after execution completes
unsandbox.
Type your browser LocalStorage password to unlock the API secret vault.