unsandbox.com
Anonymous remote code, compile, & execution API for humans & machine learning agents.
Docs 📚 View Pricing →The Haskell examples below require the following 3rd party libraries:
http-simple or http-conduitaeson
Make sure these packages are installed in your environment before running the examples.
Execute code immediately and wait for results. Best for quick scripts and interactive use.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
language |
string | ✓ | Programming language |
code |
string | ✓ | Source code to execute |
env |
object | Environment variables (key-value pairs) | |
network_mode |
string | "zerotrust" or "semitrusted" | |
ttl |
integer | Timeout 1-900s (default: 60) | |
return_artifact |
boolean | Return compiled binary | |
return_wasm_artifact |
boolean | Return WebAssembly binary |
Example (Haskell)
{-# LANGUAGE OverloadedStrings #-}
import Network.HTTP.Simple
import Data.Aeson (object, (.=))
import qualified Data.ByteString.Lazy.Char8 as BL
main :: IO ()
main = do
let request = setRequestMethod "POST"
$ setRequestSecure True
$ setRequestHost "api.unsandbox.com"
$ setRequestPath "/execute"
$ setRequestHeader "Content-Type" ["application/json"]
$ setRequestHeader "Authorization" ["Bearer fromMaybe "unsb-sk-test0-vault-unlck-12345" <$> lookupEnv "UNSANDBOX_API_KEY""]
$ setRequestBodyJSON (object
[ "language" .= ("haskell" :: String)
, "code" .= ("main = putStrLn \"Hello from unsandbox!\"" :: String)
])
$ defaultRequest
response <- httpLBS request
BL.putStrLn $ getResponseBody response
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
| Parameter | Type | Required | Description |
|---|---|---|---|
language |
string | ✓ | Programming language |
code |
string | ✓ | Source code to execute |
env |
object | Environment variables (key-value pairs) | |
network_mode |
string | "zerotrust" or "semitrusted" | |
ttl |
integer | Timeout 1-900s (default: 60) | |
return_artifact |
boolean | Return compiled binary | |
return_wasm_artifact |
boolean | Return WebAssembly binary |
Example (Haskell)
{-# LANGUAGE OverloadedStrings #-}
import Network.HTTP.Simple
import Data.Aeson (object, (.=))
import qualified Data.ByteString.Lazy.Char8 as BL
main :: IO ()
main = do
let request = setRequestMethod "POST"
$ setRequestSecure True
$ setRequestHost "api.unsandbox.com"
$ setRequestPath "/execute/async"
$ setRequestHeader "Content-Type" ["application/json"]
$ setRequestHeader "Authorization" ["Bearer fromMaybe "unsb-sk-test0-vault-unlck-12345" <$> lookupEnv "UNSANDBOX_API_KEY""]
$ setRequestBodyJSON (object
[ "language" .= ("haskell" :: String)
, "code" .= ("main = do\n putStrLn \"Computing factorial...\"\n print $ product [1..20]" :: String)
, "ttl" .= (300 :: Int)
])
$ defaultRequest
response <- httpLBS request
BL.putStrLn $ getResponseBody response
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
| Parameter | Type | Description |
|---|---|---|
id |
string | Job ID returned from async endpoint |
Example (Haskell)
{-# LANGUAGE OverloadedStrings #-}
import Network.HTTP.Simple
import qualified Data.ByteString.Lazy.Char8 as BL
main :: IO ()
main = do
let request = setRequestMethod "GET"
$ setRequestSecure True
$ setRequestHost "api.unsandbox.com"
$ setRequestPath "/jobs/job_1234567890_abc"
$ setRequestHeader "Authorization" ["Bearer fromMaybe "unsb-sk-test0-vault-unlck-12345" <$> lookupEnv "UNSANDBOX_API_KEY""]
$ defaultRequest
response <- httpLBS request
BL.putStrLn $ getResponseBody 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 executerunning- Job currently executingcompleted- Job finished (check result field)timeout- Job exceeded TTL limitcancelled- Job was cancelled via DELETE
List all active (pending or running) jobs for your API key. Useful for monitoring multiple async executions.
Example (Haskell)
{-# LANGUAGE OverloadedStrings #-}
import Network.HTTP.Simple
import qualified Data.ByteString.Lazy.Char8 as BL
main :: IO ()
main = do
let request = setRequestMethod "GET"
$ setRequestSecure True
$ setRequestHost "api.unsandbox.com"
$ setRequestPath "/jobs"
$ setRequestHeader "Authorization" ["Bearer fromMaybe "unsb-sk-test0-vault-unlck-12345" <$> lookupEnv "UNSANDBOX_API_KEY""]
$ defaultRequest
response <- httpLBS request
BL.putStrLn $ getResponseBody 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
| Parameter | Type | Description |
|---|---|---|
id |
string | Job ID to cancel |
Example (Haskell)
{-# LANGUAGE OverloadedStrings #-}
import Network.HTTP.Simple
import qualified Data.ByteString.Lazy.Char8 as BL
main :: IO ()
main = do
let request = setRequestMethod "DELETE"
$ setRequestSecure True
$ setRequestHost "api.unsandbox.com"
$ setRequestPath "/jobs/job_1234567890_abc"
$ setRequestHeader "Authorization" ["Bearer fromMaybe "unsb-sk-test0-vault-unlck-12345" <$> lookupEnv "UNSANDBOX_API_KEY""]
$ defaultRequest
response <- httpLBS request
BL.putStrLn $ getResponseBody 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
| Parameter | Type | Required | Description |
|---|---|---|---|
env |
string | URL-encoded JSON object with environment variables | |
network_mode |
string | "zerotrust" or "semitrusted" | |
ttl |
integer | Timeout 1-900s (default: 60) | |
return_artifact |
boolean | Return compiled binary | |
return_wasm_artifact |
boolean | Return WebAssembly binary |
Example (Haskell)
{-# LANGUAGE OverloadedStrings #-}
import Network.HTTP.Simple
import qualified Data.ByteString.Char8 as BS
import qualified Data.ByteString.Lazy.Char8 as BL
main :: IO ()
main = do
let request = setRequestMethod "POST"
$ setRequestSecure True
$ setRequestHost "api.unsandbox.com"
$ setRequestPath "/run"
$ setRequestHeader "Content-Type" ["text/plain"]
$ setRequestHeader "Authorization" ["Bearer fromMaybe "unsb-sk-test0-vault-unlck-12345" <$> lookupEnv "UNSANDBOX_API_KEY""]
$ setRequestBodyBS (BS.pack "main = putStrLn \"Language auto-detected!\"")
$ defaultRequest
response <- httpLBS request
BL.putStrLn $ getResponseBody 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
| Parameter | Type | Required | Description |
|---|---|---|---|
env |
string | URL-encoded JSON object with environment variables | |
network_mode |
string | "zerotrust" or "semitrusted" | |
ttl |
integer | Timeout 1-900s (default: 60) | |
return_artifact |
boolean | Return compiled binary | |
return_wasm_artifact |
boolean | Return WebAssembly binary |
Example (Haskell)
{-# LANGUAGE OverloadedStrings #-}
import Network.HTTP.Simple
import qualified Data.ByteString.Char8 as BS
import qualified Data.ByteString.Lazy.Char8 as BL
main :: IO ()
main = do
let code = "main = do\n putStrLn \"Running async with auto-detect!\"\n print $ sum [1..1000000]"
request = setRequestMethod "POST"
$ setRequestSecure True
$ setRequestHost "api.unsandbox.com"
$ setRequestPath "/run/async"
$ setRequestHeader "Content-Type" ["text/plain"]
$ setRequestHeader "Authorization" ["Bearer fromMaybe "unsb-sk-test0-vault-unlck-12345" <$> lookupEnv "UNSANDBOX_API_KEY""]
$ setRequestBodyBS (BS.pack code)
$ defaultRequest
response <- httpLBS request
BL.putStrLn $ getResponseBody response
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
}
}