Skip to main content
POST
/
v1
/
sandboxes
/
{id}
/
code
/
runs
Create an async code execution run
import requests

url = "https://api.13-215-85-171.sslip.io/v1/sandboxes/{id}/code/runs"

payload = {
    "code": "<string>",
    "context_id": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
{
  "id": "<string>",
  "sandbox_id": "<string>",
  "context_id": "<string>",
  "timeout_secs": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "cancel_requested_at": "2023-11-07T05:31:56Z",
  "execution": {
    "results": [
      {
        "text": "<string>",
        "html": "<string>",
        "markdown": "<string>",
        "svg": "<string>",
        "png": "<string>",
        "jpeg": "<string>",
        "pdf": "<string>",
        "latex": "<string>",
        "json": "<unknown>",
        "javascript": "<string>",
        "data": {},
        "is_main_result": true
      }
    ],
    "artifacts": [
      {
        "id": "<string>",
        "context_id": "<string>",
        "mime_type": "<string>",
        "name": "<string>",
        "size_bytes": 123,
        "sha256": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "execution_count": 123,
        "expires_at": "2023-11-07T05:31:56Z",
        "preview_url": "<string>",
        "download_url": "<string>",
        "metadata": {}
      }
    ],
    "logs": {
      "stdout": [
        "<string>"
      ],
      "stderr": [
        "<string>"
      ]
    },
    "error": {
      "name": "<string>",
      "value": "<string>",
      "traceback": "<string>"
    },
    "execution_count": 123
  },
  "failure_reason": "<string>"
}

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Path Parameters

id
string
required

Sandbox ID (e.g. sb_a1b2c3d4)

Body

application/json
code
string
required

Source code to execute

context_id
string
required

Existing kernel context ID to run against

envs
object
timeout
integer

Execution timeout in seconds

Response

Run accepted

id
string
required
sandbox_id
string
required
context_id
string
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed,
cancelled
timeout_secs
integer
required
created_at
string<date-time>
required
expires_at
string<date-time>
required
started_at
string<date-time> | null
completed_at
string<date-time> | null
cancel_requested_at
string<date-time> | null
execution
object
failure_reason
string | null