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

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

async function run() {
  const result = await sdk.sandbox.get({
    sessionId: "demo-python-20260316",
  });

  console.log(result);
}

run();
{
  "session_id": "demo-python-20260316",
  "user_id": "demo-user",
  "status": "idle",
  "sandbox_features": [],
  "api_key_id": null,
  "permissions": [],
  "runner_id": "runner-usw2a-01",
  "runner_url": "http://runner:8010",
  "runner_zone": "us-west-2a",
  "created_at": "2026-03-16T20:40:00Z",
  "updated_at": "2026-03-16T20:40:02Z"
}

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

Response

SessionRecord · object | null

Successful Response

session_id
string
required
user_id
string
required
status
enum<string>
default:pending
Available options:
pending,
provisioning,
running,
idle,
failed,
terminated
sandbox_features
string[]
api_key_id
string | null
permissions
string[]
runner_id
string | null
runner_url
string | null
runner_zone
string | null
created_at
string<date-time>
updated_at
string<date-time>