unsandbox.com

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

Request Parameters

Example (Nim)

import httpclient, json

let client = newHttpClient()
client.headers = newHttpHeaders({
  "Content-Type": "application/json",
  "Authorization": "Bearer getEnv("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")"
})

let payload = %* {
  "language": "nim",
  "code": "echo \"Hello from unsandbox!\""
}

let response = client.postContent("https://api.unsandbox.com/execute", $payload)
let result = parseJson(response)

if result["success"].getBool:
  echo "Output: ", result["stdout"].getStr
else:
  echo "Error: ", result["error"].getStr

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

import httpclient, json, os

let client = newHttpClient()
client.headers = newHttpHeaders({
  "Content-Type": "application/json",
  "Authorization": "Bearer getEnv("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")"
})

# Submit job
let payload = %* {
  "language": "rust",
  "code": "fn main() { println!(\"Computing...\"); }",
  "ttl": 300
}

let response = client.postContent("https://api.unsandbox.com/execute/async", $payload)
let job = parseJson(response)
let jobId = job["job_id"].getStr

echo "Job submitted: ", jobId

# Poll for results
while true:
  let statusResponse = client.getContent("https://api.unsandbox.com/jobs/" & jobId)
  let status = parseJson(statusResponse)

  case status["status"].getStr
  of "completed":
    let result = status["result"]
    if result["success"].getBool:
      echo "Output: ", result["stdout"].getStr
    else:
      echo "Error: ", result["stderr"].getStr
    break
  of "timeout", "cancelled":
    echo "Job ", status["status"].getStr
    break
  else:
    discard

  sleep(1000)

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

import httpclient, json

let client = newHttpClient()
client.headers = newHttpHeaders({
  "Authorization": "Bearer getEnv("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")"
})

let jobId = "job_1234567890_abc"
let response = client.getContent("https://api.unsandbox.com/jobs/" & jobId)
let job = parseJson(response)

echo "Status: ", job["status"].getStr
if job["status"].getStr == "completed":
  let result = job["result"]
  echo "Success: ", result["success"].getBool
  echo "Output: ", result["stdout"].getStr

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

import httpclient, json

let client = newHttpClient()
client.headers = newHttpHeaders({
  "Authorization": "Bearer getEnv("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")"
})

let response = client.getContent("https://api.unsandbox.com/jobs")
let jobs = parseJson(response)

for job in jobs:
  echo job["job_id"].getStr, ": ", job["status"].getStr, " (", job["language"].getStr, ")"

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

import httpclient, json

let client = newHttpClient()
client.headers = newHttpHeaders({
  "Authorization": "Bearer getEnv("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")"
})

let jobId = "job_1234567890_abc"
let response = client.request("https://api.unsandbox.com/jobs/" & jobId, httpMethod = HttpDelete)
let result = parseJson(response.body)

echo "Cancelled: ", result["message"].getStr
if result.hasKey("result"):
  echo "Partial output: ", result["stdout"].getStr

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

import httpclient, json

let client = newHttpClient()
client.headers = newHttpHeaders({
  "Content-Type": "text/plain",
  "Authorization": "Bearer getEnv("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")"
})

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

let response = client.postContent("https://api.unsandbox.com/run", code)
let result = parseJson(response)

echo "Detected: ", result["detected_language"].getStr
echo "Output: ", result["stdout"].getStr

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

import httpclient, json, os

let client = newHttpClient()
client.headers = newHttpHeaders({
  "Content-Type": "text/plain",
  "Authorization": "Bearer getEnv("UNSANDBOX_API_KEY", "unsb-sk-test0-vault-unlck-12345")"
})

let code = """#!/usr/bin/env ruby
puts "Running async with auto-detect!" """

# Submit job
let response = client.postContent("https://api.unsandbox.com/run/async", code)
let job = parseJson(response)
let jobId = job["job_id"].getStr

echo "Job submitted: ", jobId

# Poll for results
while true:
  let statusResponse = client.getContent("https://api.unsandbox.com/jobs/" & jobId)
  let status = parseJson(statusResponse)

  case status["status"].getStr
  of "completed":
    let result = status["result"]
    echo "Detected: ", result["detected_language"].getStr
    if result["success"].getBool:
      echo "Output: ", result["stdout"].getStr
    break
  of "timeout", "cancelled":
    echo "Job ", status["status"].getStr
    break
  else:
    discard

  sleep(1000)

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