unsandbox.com

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

Request Parameters

Example (Forth)

\ Execute code on unsandbox API using Forth
\ Uses SYSTEM word to call curl

: EXECUTE-CODE ( -- )
  S" curl -X POST https://api.unsandbox.com/execute "
  S" -H 'Content-Type: application/json' "
  S" -H 'Authorization: Bearer YOUR_API_KEY' "
  S" -d '{\"language\": \"forth\", "
  S" \"code\": \".\\\" Hello from unsandbox!\\\" CR\"}'"
  S"  "
  CONCATENATE CONCATENATE CONCATENATE CONCATENATE CONCATENATE
  SYSTEM DROP ;

EXECUTE-CODE
BYE

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

\ Submit async job and poll for results using Forth

: SUBMIT-JOB ( -- )
  S" curl -s -X POST https://api.unsandbox.com/execute/async "
  S" -H 'Content-Type: application/json' "
  S" -H 'Authorization: Bearer YOUR_API_KEY' "
  S" -d '{\"language\": \"forth\", "
  S" \"code\": \".\\\" Computing...\\\" CR\", "
  S" \"ttl\": 300}' > /tmp/forth_job.json"
  CONCATENATE CONCATENATE CONCATENATE CONCATENATE CONCATENATE
  SYSTEM DROP ;

: POLL-JOB ( -- )
  S" curl -s https://api.unsandbox.com/jobs/"
  S" $(grep -o '\"job_id\":\"[^\"]*\"' /tmp/forth_job.json | cut -d'\"' -f4) "
  S" -H 'Authorization: Bearer YOUR_API_KEY'"
  CONCATENATE CONCATENATE
  SYSTEM DROP ;

: CLEANUP ( -- )
  S" rm -f /tmp/forth_job.json" SYSTEM DROP ;

: EXECUTE-ASYNC ( -- )
  SUBMIT-JOB
  .\" Job submitted. Polling for results..." CR
  5 0 DO
    POLL-JOB
    1000 MS  \ Wait 1 second
  LOOP
  CLEANUP ;

EXECUTE-ASYNC
BYE

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

\ Get job status from unsandbox API using Forth

: GET-JOB ( -- )
  S" curl https://api.unsandbox.com/jobs/job_1234567890_abc "
  S" -H 'Authorization: Bearer YOUR_API_KEY'"
  CONCATENATE
  SYSTEM DROP ;

GET-JOB
BYE

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

\ List all jobs from unsandbox API using Forth

: LIST-JOBS ( -- )
  S" curl https://api.unsandbox.com/jobs "
  S" -H 'Authorization: Bearer YOUR_API_KEY'"
  CONCATENATE
  SYSTEM DROP ;

LIST-JOBS
BYE

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

\ Delete a job from unsandbox API using Forth

: DELETE-JOB ( -- )
  S" curl -X DELETE https://api.unsandbox.com/jobs/job_1234567890_abc "
  S" -H 'Authorization: Bearer YOUR_API_KEY'"
  CONCATENATE
  SYSTEM DROP ;

DELETE-JOB
BYE

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

\ Run code with auto-detect on unsandbox API using Forth

: RUN-CODE ( -- )
  S" curl -X POST https://api.unsandbox.com/run "
  S" -H 'Content-Type: text/plain' "
  S" -H 'Authorization: Bearer YOUR_API_KEY' "
  S" --data-binary '.\" Language auto-detected!\" CR'"
  CONCATENATE CONCATENATE CONCATENATE
  SYSTEM DROP ;

RUN-CODE
BYE

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

\ Submit async run job and poll for results using Forth

: SUBMIT-RUN ( -- )
  S" curl -s -X POST https://api.unsandbox.com/run/async "
  S" -H 'Content-Type: text/plain' "
  S" -H 'Authorization: Bearer YOUR_API_KEY' "
  S" --data-binary '.\" Running async!\" CR' "
  S" > /tmp/forth_run_job.json"
  CONCATENATE CONCATENATE CONCATENATE CONCATENATE
  SYSTEM DROP ;

: POLL-RUN ( -- )
  S" curl -s https://api.unsandbox.com/jobs/"
  S" $(grep -o '\"job_id\":\"[^\"]*\"' /tmp/forth_run_job.json | cut -d'\"' -f4) "
  S" -H 'Authorization: Bearer YOUR_API_KEY'"
  CONCATENATE CONCATENATE
  SYSTEM DROP ;

: CLEANUP-RUN ( -- )
  S" rm -f /tmp/forth_run_job.json" SYSTEM DROP ;

: RUN-ASYNC ( -- )
  SUBMIT-RUN
  .\" Job submitted. Polling for results..." CR
  5 0 DO
    POLL-RUN
    1000 MS  \ Wait 1 second
  LOOP
  CLEANUP-RUN ;

RUN-ASYNC
BYE

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