Typescript (SDK)

import { SDK } from "@meetkai/mka1";

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

async function run() {
  const result = await sdk.sandbox.create({
    createSessionRequest: {
      sessionId: "demo-python-20260316",
      sessionKind: "standard",
      sandboxFeatures: [],
      runtimeProfile: "standard",
    },
  });

  console.log(result);
}

run();

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;
using System.Collections.Generic;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.Sandbox.CreateAsync(body: new MeetKai.MKA1.Types.Components.CreateSessionRequest() {
    SessionId = "demo-python-20260316",
    SessionKind = SessionKind.Standard,
    SandboxFeatures = new List<SandboxFeature>() {},
    RuntimeProfile = SandboxRuntimeProfile.Standard,
});

// handle response

from meetkai_mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.sandbox.create(session_id="demo-python-20260316", user_id="demo-user", session_kind="standard", ttl_seconds=600, sandbox_features=[], runtime_profile="standard", queue_if_full=False, skip_llm_credential_exchange=False)

    # Handle response
    print(res)

curl --request POST \
  --url https://apigw.mka1.com/api/v1/sandbox/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "demo-python-20260316",
  "user_id": "demo-user",
  "session_kind": "standard",
  "ttl_seconds": 600,
  "sandbox_features": [],
  "runtime_profile": "standard",
  "queue_if_full": false
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    session_id: 'demo-python-20260316',
    user_id: 'demo-user',
    session_kind: 'standard',
    ttl_seconds: 600,
    sandbox_features: [],
    runtime_profile: 'standard',
    queue_if_full: false
  })
};

fetch('https://apigw.mka1.com/api/v1/sandbox/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/sandbox/sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'session_id' => 'demo-python-20260316',
    'user_id' => 'demo-user',
    'session_kind' => 'standard',
    'ttl_seconds' => 600,
    'sandbox_features' => [
        
    ],
    'runtime_profile' => 'standard',
    'queue_if_full' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apigw.mka1.com/api/v1/sandbox/sessions"

	payload := strings.NewReader("{\n  \"session_id\": \"demo-python-20260316\",\n  \"user_id\": \"demo-user\",\n  \"session_kind\": \"standard\",\n  \"ttl_seconds\": 600,\n  \"sandbox_features\": [],\n  \"runtime_profile\": \"standard\",\n  \"queue_if_full\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/sandbox/sessions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"session_id\": \"demo-python-20260316\",\n  \"user_id\": \"demo-user\",\n  \"session_kind\": \"standard\",\n  \"ttl_seconds\": 600,\n  \"sandbox_features\": [],\n  \"runtime_profile\": \"standard\",\n  \"queue_if_full\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/sandbox/sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"session_id\": \"demo-python-20260316\",\n  \"user_id\": \"demo-user\",\n  \"session_kind\": \"standard\",\n  \"ttl_seconds\": 600,\n  \"sandbox_features\": [],\n  \"runtime_profile\": \"standard\",\n  \"queue_if_full\": false\n}"

response = http.request(request)
puts response.read_body

{
  "session": {
    "session_id": "demo-python-20260316",
    "user_id": "demo-user",
    "status": "idle",
    "session_kind": "standard",
    "ttl_seconds": 600,
    "workspace_expires_at": "2026-03-23T20:40:00Z",
    "sandbox_features": [],
    "runtime_profile": "standard",
    "api_key_id": null,
    "permissions": [],
    "created_at": "2026-03-16T20:40:00Z",
    "updated_at": "2026-03-16T20:40:02Z"
  },
  "session_token": "sandbox_test_20260316_4f9c2b1a",
  "provider": "runner-firecracker"
}

{
  "session": {
    "session_id": "demo-python-20260316",
    "user_id": "demo-user",
    "status": "queued",
    "session_kind": "standard",
    "ttl_seconds": 600,
    "workspace_expires_at": "2026-03-23T20:40:00Z",
    "sandbox_features": [],
    "runtime_profile": "standard",
    "api_key_id": null,
    "permissions": [],
    "created_at": "2026-03-16T20:40:00Z",
    "updated_at": "2026-03-16T20:41:00Z"
  },
  "session_token": "sandbox_test_20260316_4f9c2b1a",
  "provider": null
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": {
    "code": "browser_sessions_not_enabled",
    "message": "Browser sessions are not enabled in this environment."
  }
}

Sessions

Crear sesión

Crea una sesión de sandbox y devuelve sus metadatos públicos de sesión, el token de sesión y el proveedor. Establece session_kind en browser para iniciar una sesión respaldada por navegador en lugar de un sandbox estándar de comandos/código. Establece queue_if_full en true para poner la solicitud en cola en lugar de fallar cuando la capacidad del ejecutor no esté temporalmente disponible. No pone en cola solicitudes para tipos de sesión que la implementación no admite. Las sesiones de navegador requieren una implementación basada en Firecracker; las implementaciones solo estándar las rechazan inmediatamente con browser_sessions_not_enabled. Una network_policy opcional del llamador restringe los nombres de host salientes y se intersecta con las políticas de la organización, el equipo y el operador. Una lista de अनुमति vacía deniega el acceso saliente.

POST

api

sandbox

sessions

Typescript (SDK)

import { SDK } from "@meetkai/mka1";

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

async function run() {
  const result = await sdk.sandbox.create({
    createSessionRequest: {
      sessionId: "demo-python-20260316",
      sessionKind: "standard",
      sandboxFeatures: [],
      runtimeProfile: "standard",
    },
  });

  console.log(result);
}

run();

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;
using System.Collections.Generic;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.Sandbox.CreateAsync(body: new MeetKai.MKA1.Types.Components.CreateSessionRequest() {
    SessionId = "demo-python-20260316",
    SessionKind = SessionKind.Standard,
    SandboxFeatures = new List<SandboxFeature>() {},
    RuntimeProfile = SandboxRuntimeProfile.Standard,
});

// handle response

from meetkai_mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.sandbox.create(session_id="demo-python-20260316", user_id="demo-user", session_kind="standard", ttl_seconds=600, sandbox_features=[], runtime_profile="standard", queue_if_full=False, skip_llm_credential_exchange=False)

    # Handle response
    print(res)

curl --request POST \
  --url https://apigw.mka1.com/api/v1/sandbox/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "demo-python-20260316",
  "user_id": "demo-user",
  "session_kind": "standard",
  "ttl_seconds": 600,
  "sandbox_features": [],
  "runtime_profile": "standard",
  "queue_if_full": false
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    session_id: 'demo-python-20260316',
    user_id: 'demo-user',
    session_kind: 'standard',
    ttl_seconds: 600,
    sandbox_features: [],
    runtime_profile: 'standard',
    queue_if_full: false
  })
};

fetch('https://apigw.mka1.com/api/v1/sandbox/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/sandbox/sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'session_id' => 'demo-python-20260316',
    'user_id' => 'demo-user',
    'session_kind' => 'standard',
    'ttl_seconds' => 600,
    'sandbox_features' => [
        
    ],
    'runtime_profile' => 'standard',
    'queue_if_full' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apigw.mka1.com/api/v1/sandbox/sessions"

	payload := strings.NewReader("{\n  \"session_id\": \"demo-python-20260316\",\n  \"user_id\": \"demo-user\",\n  \"session_kind\": \"standard\",\n  \"ttl_seconds\": 600,\n  \"sandbox_features\": [],\n  \"runtime_profile\": \"standard\",\n  \"queue_if_full\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/sandbox/sessions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"session_id\": \"demo-python-20260316\",\n  \"user_id\": \"demo-user\",\n  \"session_kind\": \"standard\",\n  \"ttl_seconds\": 600,\n  \"sandbox_features\": [],\n  \"runtime_profile\": \"standard\",\n  \"queue_if_full\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/sandbox/sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"session_id\": \"demo-python-20260316\",\n  \"user_id\": \"demo-user\",\n  \"session_kind\": \"standard\",\n  \"ttl_seconds\": 600,\n  \"sandbox_features\": [],\n  \"runtime_profile\": \"standard\",\n  \"queue_if_full\": false\n}"

response = http.request(request)
puts response.read_body

{
  "session": {
    "session_id": "demo-python-20260316",
    "user_id": "demo-user",
    "status": "idle",
    "session_kind": "standard",
    "ttl_seconds": 600,
    "workspace_expires_at": "2026-03-23T20:40:00Z",
    "sandbox_features": [],
    "runtime_profile": "standard",
    "api_key_id": null,
    "permissions": [],
    "created_at": "2026-03-16T20:40:00Z",
    "updated_at": "2026-03-16T20:40:02Z"
  },
  "session_token": "sandbox_test_20260316_4f9c2b1a",
  "provider": "runner-firecracker"
}

{
  "session": {
    "session_id": "demo-python-20260316",
    "user_id": "demo-user",
    "status": "queued",
    "session_kind": "standard",
    "ttl_seconds": 600,
    "workspace_expires_at": "2026-03-23T20:40:00Z",
    "sandbox_features": [],
    "runtime_profile": "standard",
    "api_key_id": null,
    "permissions": [],
    "created_at": "2026-03-16T20:40:00Z",
    "updated_at": "2026-03-16T20:41:00Z"
  },
  "session_token": "sandbox_test_20260316_4f9c2b1a",
  "provider": null
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": {
    "code": "browser_sessions_not_enabled",
    "message": "Browser sessions are not enabled in this environment."
  }
}

Autorizaciones

Authorization

string

header

requerido

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

Encabezados

X-On-Behalf-Of

string

Optional external end-user identifier forwarded by the API gateway.

Cuerpo

application/json

session_id

string

requerido

Required string length: 1 - 255

memory_limit_mib

enum<integer> | null

Límite máximo de memoria del invitado: 512, 1024 o 2048 MiB para sesiones estándar. Desactiva el crecimiento automático de memoria y los reintentos por OOM.

Opciones disponibles:

512,

1024,

2048

network_policy

OutboundNetworkPolicy · object | null

Lista de अनुमति de nombres de host de salida adicional. Interseca las restricciones del inquilino y del operador; una lista vacía deniega los hosts de salida.

Show child attributes

session_key

string | null

user_id

string

predeterminado:demo-user

session_kind

enum<string>

predeterminado:standard

Opciones disponibles:

standard,

browser,

coding_harness

resource_class

enum<string> | null

Clases de dimensionamiento de cargas de trabajo propiedad del servidor.

Las clases de recursos son deliberadamente independientes del perfil de lenguaje/runtime. En particular, Coding Harness siempre usa la clase Medium incluso cuando un llamante envía un valor heredado memory_mib más pequeño o ausente.

Opciones disponibles:

medium

ttl_seconds

integer

predeterminado:600

Rango requerido: x >= 1

sandbox_features

enum<string>[]

Opciones disponibles:

python,

git,

claude-code

runtime_profile

enum<string>

predeterminado:standard

Opciones disponibles:

standard,

eval-python

memory_mounts

MemoryMount · object[]

Show child attributes

queue_if_full

boolean

predeterminado:false

skip_llm_credential_exchange

boolean

predeterminado:false

environment_id

integer | null

Rango requerido: x >= 1

coding_harness_skills

Coding Harness Skills · object | null

Respuesta

Respuesta Exitosa

session

SessionRecord · object

requerido

Show child attributes

session_token

string | null

provider

enum<string> | null

Opciones disponibles:

in-memory,

runner-process,

runner-docker,

runner-firecracker

⌘I

Responses and conversations

Models and routing

Images and audio

Files and retrieval

Agents

Tools and sandbox

Evals and feedback

Compute

Repositories

Dataset generations

Organizations and access

Usage and budgets

Application utilities

Analytics

Legacy APIs

Additional APIs

Crear sesión

Autorizaciones

Encabezados

Cuerpo

Respuesta