unsandbox.com

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

Request Parameters

Example (Ruby)

require 'net/http'
require 'json'
require 'uri'

url = URI("https://api.unsandbox.com/execute")
headers = {
  "Content-Type" => "application/json",
  "Authorization" => "Bearer #{ ENV["UNSANDBOX_API_KEY"] || "unsb-sk-test0-vault-unlck-12345" }"
}
payload = {
  language: "python",
  code: "print('Hello from unsandbox!')"
}

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url, headers)
request.body = payload.to_json

response = http.request(request)
result = JSON.parse(response.body)

if result["success"]
  puts "Output: #{result['stdout']}"
else
  puts "Error: #{result['error']}"
end

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

require 'net/http'
require 'json'
require 'uri'

# Submit job
url = URI("https://api.unsandbox.com/execute/async")
headers = {
  "Content-Type" => "application/json",
  "Authorization" => "Bearer #{ ENV["UNSANDBOX_API_KEY"] || "unsb-sk-test0-vault-unlck-12345" }"
}
payload = {
  language: "rust",
  code: "fn main() { println!(\"Computing...\"); }",
  ttl: 300
}

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url, headers)
request.body = payload.to_json

response = http.request(request)
job = JSON.parse(response.body)
job_id = job["job_id"]

puts "Job submitted: #{job_id}"

# Poll for results
status_url = URI("https://api.unsandbox.com/jobs/#{job_id}")
loop do
  http = Net::HTTP.new(status_url.host, status_url.port)
  http.use_ssl = true
  request = Net::HTTP::Get.new(status_url, headers)

  status_response = http.request(request)
  status = JSON.parse(status_response.body)

  if status["status"] == "completed"
    result = status["result"]
    if result && result["success"]
      puts "Output: #{result['stdout']}"
    elsif result
      puts "Error: #{result['stderr']}"
    else
      puts "Error: No result available"
    end
    break
  elsif ["timeout", "cancelled"].include?(status["status"])
    puts "Job #{status['status']}"
    break
  end

  sleep 1  # Wait 1 second before polling again
end

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

require 'net/http'
require 'json'
require 'uri'

job_id = "job_1234567890_abc"
url = URI("https://api.unsandbox.com/jobs/#{job_id}")
headers = {"Authorization" => "Bearer #{ ENV["UNSANDBOX_API_KEY"] || "unsb-sk-test0-vault-unlck-12345" }"}

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url, headers)

response = http.request(request)
job = JSON.parse(response.body)

puts "Status: #{job['status']}"
if job["status"] == "completed"
  puts "Success: #{job['result']['success']}"
  puts "Output: #{job['result']['stdout']}"
end

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

require 'net/http'
require 'json'
require 'uri'

url = URI("https://api.unsandbox.com/jobs")
headers = {"Authorization" => "Bearer #{ ENV["UNSANDBOX_API_KEY"] || "unsb-sk-test0-vault-unlck-12345" }"}

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url, headers)

response = http.request(request)
jobs = JSON.parse(response.body)

jobs.each do |job|
  puts "#{job['job_id']}: #{job['status']} (#{job['language']})"
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"
    }
  ]
}

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

URL Parameters

Example (Ruby)

require 'net/http'
require 'json'
require 'uri'

job_id = "job_1234567890_abc"
url = URI("https://api.unsandbox.com/jobs/#{job_id}")
headers = {"Authorization" => "Bearer #{ ENV["UNSANDBOX_API_KEY"] || "unsb-sk-test0-vault-unlck-12345" }"}

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url, headers)

response = http.request(request)
result = JSON.parse(response.body)

puts "Cancelled: #{result['message']}"
if result["stdout"]
  puts "Partial output: #{result['stdout']}"
end

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

require 'net/http'
require 'json'
require 'uri'

url = URI("https://api.unsandbox.com/run")
headers = {
  "Content-Type" => "text/plain",
  "Authorization" => "Bearer #{ ENV["UNSANDBOX_API_KEY"] || "unsb-sk-test0-vault-unlck-12345" }"
}
code = <<~CODE
  #!/usr/bin/env python3
  print("Language auto-detected!")
CODE

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url, headers)
request.body = code

response = http.request(request)
result = JSON.parse(response.body)

puts "Detected: #{result['detected_language']}"
puts "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 (Ruby)

require 'net/http'
require 'json'
require 'uri'

url = URI("https://api.unsandbox.com/run/async")
headers = {
  "Content-Type" => "text/plain",
  "Authorization" => "Bearer #{ ENV["UNSANDBOX_API_KEY"] || "unsb-sk-test0-vault-unlck-12345" }"
}
code = <<~CODE
  #!/usr/bin/env ruby
  puts "Running async with auto-detect!"
CODE

# Submit job
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url, headers)
request.body = code

response = http.request(request)
job = JSON.parse(response.body)
job_id = job["job_id"]

puts "Job submitted: #{job_id}"

# Poll for results
status_url = URI("https://api.unsandbox.com/jobs/#{job_id}")
loop do
  http = Net::HTTP.new(status_url.host, status_url.port)
  http.use_ssl = true
  request = Net::HTTP::Get.new(status_url, headers)

  status_response = http.request(request)
  status = JSON.parse(status_response.body)

  if status["status"] == "completed"
    result = status["result"]
    if result
      puts "Detected: #{result['detected_language']}" if result['detected_language']
      if result["success"]
        puts "Output: #{result['stdout']}"
      end
    else
      puts "Error: No result available"
    end
    break
  elsif ["timeout", "cancelled"].include?(status["status"])
    puts "Job #{status['status']}"
    break
  end

  sleep 1
end

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