unsandbox.com

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

Request Parameters

Example (PHP)

<?php

$url = "https://api.unsandbox.com/execute";
$payload = json_encode([
    "language" => "python",
    "code" => "print('Hello from unsandbox!')"
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result["success"]) {
    echo "Output: " . $result["stdout"] . "\n";
} else {
    echo "Error: " . $result["error"] . "\n";
}

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 (PHP)

<?php

// Submit job
$url = "https://api.unsandbox.com/execute/async";
$payload = json_encode([
    "language" => "rust",
    "code" => 'fn main() { println!("Computing..."); }',
    "ttl" => 300
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
]);

$response = curl_exec($ch);
curl_close($ch);

$job = json_decode($response, true);
$jobId = $job["job_id"];

echo "Job submitted: $jobId\n";

// Poll for results
$statusUrl = "https://api.unsandbox.com/jobs/$jobId";
while (true) {
    $ch = curl_init($statusUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "Authorization: Bearer YOUR_API_KEY"
    ]);

    $statusResponse = curl_exec($ch);
    curl_close($ch);

    $status = json_decode($statusResponse, true);

    if ($status["status"] == "completed") {
        $result = $status["result"];
        if ($result["success"]) {
            echo "Output: " . $result["stdout"] . "\n";
        } else {
            echo "Error: " . $result["stderr"] . "\n";
        }
        break;
    } elseif (in_array($status["status"], ["timeout", "cancelled"])) {
        echo "Job " . $status["status"] . "\n";
        break;
    }

    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 (PHP)

<?php

$jobId = "job_1234567890_abc";
$url = "https://api.unsandbox.com/jobs/$jobId";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);

$response = curl_exec($ch);
curl_close($ch);

$job = json_decode($response, true);

echo "Status: " . $job["status"] . "\n";
if ($job["status"] == "completed") {
    echo "Success: " . ($job["success"] ? "true" : "false") . "\n";
    echo "Output: " . $job["stdout"] . "\n";
}

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 (PHP)

<?php

$url = "https://api.unsandbox.com/jobs";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);

$response = curl_exec($ch);
curl_close($ch);

$jobs = json_decode($response, true);

foreach ($jobs as $job) {
    echo $job["job_id"] . ": " . $job["status"] . " (" . $job["language"] . ")\n";
}

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 (PHP)

<?php

$jobId = "job_1234567890_abc";
$url = "https://api.unsandbox.com/jobs/$jobId";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY"
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

echo "Cancelled: " . $result["message"] . "\n";
if (isset($result["stdout"])) {
    echo "Partial output: " . $result["stdout"] . "\n";
}

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 (PHP)

<?php

$url = "https://api.unsandbox.com/run";
$code = <<<'CODE'
#!/usr/bin/env python3
print("Language auto-detected!")
CODE;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $code);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: text/plain",
    "Authorization: Bearer YOUR_API_KEY"
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

echo "Detected: " . $result["detected_language"] . "\n";
echo "Output: " . $result["stdout"] . "\n";

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 (PHP)

<?php

$url = "https://api.unsandbox.com/run/async";
$code = <<<'CODE'
#!/usr/bin/env ruby
puts "Running async with auto-detect!"
CODE;

// Submit job
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $code);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: text/plain",
    "Authorization: Bearer YOUR_API_KEY"
]);

$response = curl_exec($ch);
curl_close($ch);

$job = json_decode($response, true);
$jobId = $job["job_id"];

echo "Job submitted: $jobId\n";

// Poll for results
$statusUrl = "https://api.unsandbox.com/jobs/$jobId";
while (true) {
    $ch = curl_init($statusUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "Authorization: Bearer YOUR_API_KEY"
    ]);

    $statusResponse = curl_exec($ch);
    curl_close($ch);

    $status = json_decode($statusResponse, true);

    if ($status["status"] == "completed") {
        $result = $status["result"];
        echo "Detected: " . $result["detected_language"] . "\n";
        if ($result["success"]) {
            echo "Output: " . $result["stdout"] . "\n";
        }
        break;
    } elseif (in_array($status["status"], ["timeout", "cancelled"])) {
        echo "Job " . $status["status"] . "\n";
        break;
    }

    sleep(1);  // Wait 1 second before polling again
}

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