Skip to main content
POST
/
api
/
v1
/
sandbox
/
sessions
/
{session_id}
/
commands
Typescript (SDK)
import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await sdk.sandbox.runCommand({
    sessionId: "demo-python-20260316",
    commandRequest: {
      sessionId: "demo-python-20260316",
      sessionToken: "sandbox_test_20260316_4f9c2b1a",
      command: "python3",
      args: [
        "-c",
        "import math; print(math.sqrt(144))",
      ],
      cwd: null,
      env: {

      },
    },
  });

  console.log(result);
}

run();
{
  "session_id": "demo-python-20260316",
  "command": "python3",
  "args": [
    "-c",
    "import math; print(math.sqrt(144))"
  ],
  "cwd": "/workspace",
  "stdout": "12.0\n",
  "stderr": "",
  "exit_code": 0,
  "files_changed": []
}

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Path Parameters

session_id
string
required

Body

application/json
session_id
string
required
session_token
string
required
command
string
required
args
string[]
cwd
string | null
env
Env · object
timeout_seconds
integer
default:60

Response

Successful Response

session_id
string
required
command
string
required
cwd
string
required
exit_code
integer
required
args
string[]
stdout
string
default:""
stderr
string
default:""
files_changed
string[]