unsandbox.com

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

Request Parameters

Example (TypeScript)

import axios from "axios";

const url: string = "https://api.unsandbox.com/execute";
const headers = {
  "Content-Type": "application/json",
  Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
};
const payload = {
  language: "python",
  code: "print('Hello from unsandbox!')",
};

axios
  .post(url, payload, { headers })
  .then((response) => {
    const result = response.data;
    if (result.success) {
      console.log("Output:", result.stdout);
    } else {
      console.log("Error:", result.error);
    }
  })
  .catch((error) => console.error("Request failed:", 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 (TypeScript)

import axios from "axios";

const headers = {
  "Content-Type": "application/json",
  Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
};

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

// Submit job
axios
  .post("https://api.unsandbox.com/execute/async", payload, { headers })
  .then(async (response) => {
    const jobId = response.data.job_id;
    console.log(`Job submitted: ${jobId}`);

    // Poll for results
    const statusUrl = `https://api.unsandbox.com/jobs/${jobId}`;
    while (true) {
      const statusResp = await axios.get(statusUrl, { headers });
      const status = statusResp.data;

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

      await new Promise((resolve) => setTimeout(resolve, 1000));
    }
  })
  .catch((error) => console.error("Request failed:", error));

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

import axios from "axios";

const jobId = "job_1234567890_abc";
const url = `https://api.unsandbox.com/jobs/${jobId}`;
const headers = {
  Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
};

axios
  .get(url, { headers })
  .then((response) => {
    const job = response.data;
    console.log(`Status: ${job.status}`);
    if (job.status === "completed") {
      console.log(`Success: ${job.success}`);
      console.log(`Output: ${job.stdout}`);
    }
  })
  .catch((error) => console.error("Request failed:", error));

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

import axios from "axios";

const url = "https://api.unsandbox.com/jobs";
const headers = {
  Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
};

axios
  .get(url, { headers })
  .then((response) => {
    const jobs = response.data;
    jobs.forEach((job) => {
      console.log(`${job.job_id}: ${job.status} (${job.language})`);
    });
  })
  .catch((error) => console.error("Request failed:", error));

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

import axios from "axios";

const jobId = "job_1234567890_abc";
const url = `https://api.unsandbox.com/jobs/${jobId}`;
const headers = {
  Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
};

axios
  .delete(url, { headers })
  .then((response) => {
    const result = response.data;
    console.log(`Cancelled: ${result.message}`);
    if (result.result) {
      console.log(`Partial output: ${result.stdout}`);
    }
  })
  .catch((error) => console.error("Request failed:", error));

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

import axios from "axios";

const url = "https://api.unsandbox.com/run";
const headers = {
  "Content-Type": "text/plain",
  Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
};
const code = `#!/usr/bin/env python3
print("Language auto-detected!")`;

axios
  .post(url, code, { headers })
  .then((response) => {
    const result = response.data;
    console.log(`Detected: ${result.detected_language}`);
    console.log(`Output: ${result.stdout}`);
  })
  .catch((error) => console.error("Request failed:", error));

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

import axios from "axios";

const headers = {
  "Content-Type": "text/plain",
  Authorization: `Bearer ${process.env.UNSANDBOX_API_KEY || "unsb-sk-test0-vault-unlck-12345"}`,
};
const code = `#!/usr/bin/env ruby
puts "Running async with auto-detect!"`;

// Submit job
axios
  .post("https://api.unsandbox.com/run/async", code, { headers })
  .then(async (response) => {
    const jobId = response.data.job_id;
    console.log(`Job submitted: ${jobId}`);

    // Poll for results
    const statusUrl = `https://api.unsandbox.com/jobs/${jobId}`;
    while (true) {
      const statusResp = await axios.get(statusUrl, { headers });
      const status = statusResp.data;

      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));
    }
  })
  .catch((error) => console.error("Request failed:", error));

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