unsandbox.com

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

Request Parameters

Example (Python)

import os
import requests

url = "https://api.unsandbox.com/execute"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {os.environ.get('UNSANDBOX_API_KEY', 'unsb-sk-test0-vault-unlck-12345')}",
}
payload = {"language": "python", "code": "print('Hello from unsandbox!')"}

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

if result["success"]:
    print("Output:", result["stdout"])
else:
    print("Error:", result["error"])

Response (Success)

{
  "success": true,
  "stdout": "Hello from unsandbox!\n",
  "stderr": "",
  "error": null,
  "language": "python",
  "exit_code": 0
}

Response (Error)

{
  "success": false,
  "error": "Syntax error in code",
  "stderr": "SyntaxError: invalid syntax\n"
}

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

Example (Python)

import os
import requests
import time

# Submit job
url = "https://api.unsandbox.com/execute/async"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {os.environ.get('UNSANDBOX_API_KEY', 'unsb-sk-test0-vault-unlck-12345')}",
}
payload = {
    "language": "rust",
    "code": 'fn main() { println!("Computing..."); }',
    "ttl": 300,
}

response = requests.post(url, json=payload, headers=headers)
job = response.json()
job_id = job["job_id"]

print(f"Job submitted: {job_id}")

# Poll for results
status_url = f"https://api.unsandbox.com/jobs/{job_id}"
while True:
    status_response = requests.get(status_url, headers=headers)
    status = status_response.json()

    if status["status"] == "completed":
        if status.get("success"):
            print("Output:", status.get("stdout", ""))
        else:
            print("Error:", status.get("stderr", ""))
        break
    elif status["status"] in ["timeout", "cancelled"]:
        print(f"Job {status['status']}")
        break

    time.sleep(1)  # Wait 1 second before polling again

Initial Response

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

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

URL Parameters

Example (Python)

import os
import requests

job_id = "job_1234567890_abc"
url = f"https://api.unsandbox.com/jobs/{job_id}"
headers = {
    "Authorization": f"Bearer {os.environ.get("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")}"
}

response = requests.get(url, headers=headers)

if response.status_code == 404:
    print("Job not found (already completed or never existed)")
else:
    job = response.json()
    print(f"Status: {job['status']}")
    if job["status"] == "completed":
        print(f"Success: {job.get('success', False)}")
        print(f"Output: {job.get('stdout', '')}")

Response (Completed)

{
  "job_id": "job_1234567890_abc",
  "status": "completed",
  "result": {
    "success": true,
    "stdout": "Hello from unsandbox!\n",
    "stderr": "",
    "error": null,
    "language": "python",
    "exit_code": 0
  }
}

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

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

Example (Python)

import os
import requests

url = "https://api.unsandbox.com/jobs"
headers = {
    "Authorization": f"Bearer {os.environ.get("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")}"
}

response = requests.get(url, headers=headers)
jobs = response.json()

for job in jobs:
    print(f"{job['job_id']}: {job['status']} ({job['language']})")

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"
    }
  ]
}

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

URL Parameters

Example (Python)

import os
import requests

job_id = "job_1234567890_abc"
url = f"https://api.unsandbox.com/jobs/{job_id}"
headers = {
    "Authorization": f"Bearer {os.environ.get("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")}"
}

response = requests.delete(url, headers=headers)

if response.status_code == 404:
    print("Job not found (already completed or never existed)")
else:
    result = response.json()
    print(f"Cancelled: {result['message']}")
    if result.get("stdout"):
        print(f"Partial output: {result['stdout']}")

Response

{
  "message": "Job cancelled",
  "job_id": "job_1234567890_abc",
  "result": {
    "success": false,
    "stdout": "Partial output before cancel...",
    "stderr": "",
    "error": "Job cancelled by user",
    "exit_code": -1
  }
}

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

Example (Python)

import os
import requests

url = "https://api.unsandbox.com/run"
headers = {
    "Content-Type": "text/plain",
    "Authorization": f"Bearer {os.environ.get('UNSANDBOX_API_KEY', 'unsb-sk-test0-vault-unlck-12345')}",
}
code = """#!/usr/bin/env python3
print("Language auto-detected!")"""

response = requests.post(url, data=code, headers=headers)
result = response.json()

print(f"Detected: {result['detected_language']}")
print(f"Output: {result['stdout']}")

Response

{
  "success": true,
  "stdout": "Language auto-detected!\n",
  "stderr": "",
  "error": null,
  "detected_language": "python",
  "exit_code": 0
}

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

Example (Python)

import os
import requests
import time

url = "https://api.unsandbox.com/run/async"
headers = {
    "Content-Type": "text/plain",
    "Authorization": f"Bearer {os.environ.get('UNSANDBOX_API_KEY', 'unsb-sk-test0-vault-unlck-12345')}",
}
code = """#!/usr/bin/env ruby
puts "Running async with auto-detect!" """

# Submit job
response = requests.post(url, data=code, headers=headers)
job = response.json()
job_id = job["job_id"]

print(f"Job submitted: {job_id}")

# Poll for results
status_url = f"https://api.unsandbox.com/jobs/{job_id}"
while True:
    status_response = requests.get(status_url, headers=headers)
    status = status_response.json()

    if status["status"] == "completed":
        print(f"Detected: {status.get('detected_language', 'unknown')}")
        if status.get("success"):
            print(f"Output: {status.get('stdout', '')}")
        else:
            print(f"Error: {status.get('stderr', '')}")
        break
    elif status["status"] in ["timeout", "cancelled"]:
        print(f"Job {status['status']}")
        break

    time.sleep(1)

Initial Response

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

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

{
  "job_id": "job_1234567890_abc",
  "status": "completed",
  "result": {
    "success": true,
    "stdout": "Running async with auto-detect!\n",
    "stderr": "",
    "error": null,
    "detected_language": "ruby",
    "exit_code": 0
  }
}