unsandbox.com

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

Request Parameters

Example (Tcl)

#!/usr/bin/env tclsh
package require http

# Try to load TLS for HTTPS support
if {[catch {package require tls}] == 0} {
    ::http::register https 443 ::tls::socket
}

# Manually construct JSON payload
set payload {{"language":"python","code":"print('Hello from unsandbox!')"}}

set token [::http::geturl https://api.unsandbox.com/execute \
    -method POST \
    -headers [list \
        Content-Type "application/json" \
        Authorization "Bearer [expr {[info exists env(UNSANDBOX_API_KEY)] ? $env(UNSANDBOX_API_KEY) : "unsb-sk-test0-vault-unlck-12345"}]"] \
    -query $payload]

set status [::http::status $token]
if {$status ne "ok"} {
    puts stderr "Request failed: $status"
    exit 1
}

set response [::http::data $token]
::http::cleanup $token

# Simple JSON parsing - check exit_code
if {[regexp {"exit_code":(\d+)} $response -> exit_code] && $exit_code == 0} {
    if {[regexp {"stdout":"([^"]*)"} $response -> stdout]} {
        set stdout [string map {\\n \n \\t \t \\" "} $stdout]
        puts "Output: $stdout"
    }
} else {
    if {[regexp {"stderr":"([^"]*)"} $response -> stderr]} {
        set stderr [string map {\\n \n \\t \t \\" "} $stderr]
        puts "Error: $stderr"
    }
}

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

#!/usr/bin/env tclsh
package require http
# Try to load TLS for HTTPS support
if {[catch {package require tls}] == 0} {
    ::http::register https 443 ::tls::socket
}

# Submit job - manually construct JSON payload
set payload {{"language":"tcl","code":"puts \"Computing...\"","ttl":300}}

set token [::http::geturl https://api.unsandbox.com/execute/async \
    -method POST \
    -headers [list \
        Content-Type "application/json" \
        Authorization "Bearer [expr {[info exists env(UNSANDBOX_API_KEY)] ? $env(UNSANDBOX_API_KEY) : "unsb-sk-test0-vault-unlck-12345"}]"] \
    -query $payload]

set response [::http::data $token]
::http::cleanup $token

# Extract job_id from JSON response
if {[regexp {"job_id":"([^"]+)"} $response -> job_id]} {
    puts "Job submitted: $job_id"
} else {
    puts stderr "Failed to get job_id"
    exit 1
}

# Poll for results
while {1} {
    set token [::http::geturl https://api.unsandbox.com/jobs/$job_id \
        -headers [list Authorization "Bearer [expr {[info exists env(UNSANDBOX_API_KEY)] ? $env(UNSANDBOX_API_KEY) : "unsb-sk-test0-vault-unlck-12345"}]"]]

    set status_response [::http::data $token]
    ::http::cleanup $token

    # Extract status field
    if {[regexp {"status":"([^"]+)"} $status_response -> state]} {
        if {$state eq "completed"} {
            # Extract stdout field
            if {[regexp {"stdout":"([^"]*)"} $status_response -> stdout]} {
                set stdout [string map {\\n \n \\t \t \\" "} $stdout]
                puts $stdout
            }
            break
        } elseif {$state eq "timeout" || $state eq "cancelled"} {
            puts "Job $state"
            break
        }
    }

    after 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 (Tcl)

#!/usr/bin/env tclsh
package require http
# Try to load TLS for HTTPS support
if {[catch {package require tls}] == 0} {
    ::http::register https 443 ::tls::socket
}

set token [::http::geturl https://api.unsandbox.com/jobs/job_1234567890_abc \
    -headers [list Authorization "Bearer [expr {[info exists env(UNSANDBOX_API_KEY)] ? $env(UNSANDBOX_API_KEY) : "unsb-sk-test0-vault-unlck-12345"}]"]]

set status [::http::status $token]
if {$status ne "ok"} {
    puts stderr "Request failed: $status"
    exit 1
}

set response [::http::data $token]
::http::cleanup $token

puts $response

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

#!/usr/bin/env tclsh
package require http
# Try to load TLS for HTTPS support
if {[catch {package require tls}] == 0} {
    ::http::register https 443 ::tls::socket
}

set token [::http::geturl https://api.unsandbox.com/jobs \
    -headers [list Authorization "Bearer [expr {[info exists env(UNSANDBOX_API_KEY)] ? $env(UNSANDBOX_API_KEY) : "unsb-sk-test0-vault-unlck-12345"}]"]]

set status [::http::status $token]
if {$status ne "ok"} {
    puts stderr "Request failed: $status"
    exit 1
}

set response [::http::data $token]
::http::cleanup $token

puts $response

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

#!/usr/bin/env tclsh
package require http
# Try to load TLS for HTTPS support
if {[catch {package require tls}] == 0} {
    ::http::register https 443 ::tls::socket
}

set token [::http::geturl https://api.unsandbox.com/jobs/job_1234567890_abc \
    -method DELETE \
    -headers [list Authorization "Bearer [expr {[info exists env(UNSANDBOX_API_KEY)] ? $env(UNSANDBOX_API_KEY) : "unsb-sk-test0-vault-unlck-12345"}]"]]

set status [::http::status $token]
if {$status ne "ok"} {
    puts stderr "Request failed: $status"
    exit 1
}

set response [::http::data $token]
::http::cleanup $token

puts $response

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

#!/usr/bin/env tclsh
package require http
# Try to load TLS for HTTPS support
if {[catch {package require tls}] == 0} {
    ::http::register https 443 ::tls::socket
}

set code {#!/usr/bin/env tclsh
puts "Language auto-detected!"}

set token [::http::geturl https://api.unsandbox.com/run \
    -method POST \
    -headers [list \
        Content-Type "text/plain" \
        Authorization "Bearer [expr {[info exists env(UNSANDBOX_API_KEY)] ? $env(UNSANDBOX_API_KEY) : "unsb-sk-test0-vault-unlck-12345"}]"] \
    -query $code]

set status [::http::status $token]
if {$status ne "ok"} {
    puts stderr "Request failed: $status"
    exit 1
}

set response [::http::data $token]
::http::cleanup $token

# Simple JSON parsing - extract stdout field
if {[regexp {"stdout":"([^"]*)"} $response -> stdout]} {
    puts $stdout
} else {
    puts $response
}

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

#!/usr/bin/env tclsh
package require http
# Try to load TLS for HTTPS support
if {[catch {package require tls}] == 0} {
    ::http::register https 443 ::tls::socket
}

# Submit job
set code {#!/usr/bin/env tclsh
puts "Running async with auto-detect!"}

set token [::http::geturl https://api.unsandbox.com/run/async \
    -method POST \
    -headers [list \
        Content-Type "text/plain" \
        Authorization "Bearer [expr {[info exists env(UNSANDBOX_API_KEY)] ? $env(UNSANDBOX_API_KEY) : "unsb-sk-test0-vault-unlck-12345"}]"] \
    -query $code]

set response [::http::data $token]
::http::cleanup $token

# Extract job_id from JSON response
if {[regexp {"job_id":"([^"]+)"} $response -> job_id]} {
    puts "Job submitted: $job_id"
} else {
    puts stderr "Failed to get job_id"
    exit 1
}

# Poll for results
while {1} {
    set token [::http::geturl https://api.unsandbox.com/jobs/$job_id \
        -headers [list Authorization "Bearer [expr {[info exists env(UNSANDBOX_API_KEY)] ? $env(UNSANDBOX_API_KEY) : "unsb-sk-test0-vault-unlck-12345"}]"]]

    set status_response [::http::data $token]
    ::http::cleanup $token

    # Extract status field
    if {[regexp {"status":"([^"]+)"} $status_response -> state]} {
        if {$state eq "completed"} {
            puts $status_response
            break
        } elseif {$state eq "timeout" || $state eq "cancelled"} {
            puts "Job $state"
            break
        }
    }

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