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

Criar Sessão

Crie uma sessão sandbox e retorne seus metadados públicos da sessão, o token da sessão e o provedor. Defina session_kind como browser para iniciar uma sessão apoiada por navegador em vez de um sandbox padrão de comando/código. Defina queue_if_full como true para enfileirar a solicitação em vez de falhar quando a capacidade do runner estiver temporariamente indisponível. Isso não enfileira solicitações para tipos de sessão que a implantação não suporta. Sessões de navegador exigem uma implantação com suporte do Firecracker; implantações apenas padrão as rejeitam imediatamente com browser_sessions_not_enabled. Uma network_policy opcional do chamador restringe os hostnames de saída e é combinada com as políticas da organização, da equipe e do operador. Uma allowlist vazia nega acesso de saída.

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

Autorizações

Authorization

string

header

obrigatório

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

Cabeçalhos

X-On-Behalf-Of

string

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

Corpo

application/json

session_id

string

obrigatório

Required string length: 1 - 255

memory_limit_mib

enum<integer> | null

Limite rígido de memória do convidado: 512, 1024 ou 2048 MiB para sessões padrão. Desativa o crescimento automático da memória e as novas tentativas em caso de OOM.

Opções disponíveis:

512,

1024,

2048

network_policy

OutboundNetworkPolicy · object | null

Lista de permissões adicional para hostname de saída. Intersecta as restrições do tenant e do operador; uma lista vazia nega hosts de saída.

Show child attributes

session_key

string | null

user_id

string

padrão:demo-user

session_kind

enum<string>

padrão:standard

Opções disponíveis:

standard,

browser,

coding_harness

resource_class

enum<string> | null

Classes de dimensionamento de cargas de trabalho de propriedade do servidor.

As classes de recursos são deliberadamente independentes do perfil de linguagem/runtime. Em particular, o Coding Harness sempre usa a classe Medium, mesmo quando um chamador envia um valor legacy memory_mib menor ou ausente.

Opções disponíveis:

medium

ttl_seconds

integer

padrão:600

Intervalo obrigatório: x >= 1

sandbox_features

enum<string>[]

Opções disponíveis:

python,

git,

claude-code

runtime_profile

enum<string>

padrão:standard

Opções disponíveis:

standard,

eval-python

memory_mounts

MemoryMount · object[]

Show child attributes

queue_if_full

boolean

padrão:false

skip_llm_credential_exchange

boolean

padrão:false

environment_id

integer | null

Intervalo obrigatório: x >= 1

coding_harness_skills

Coding Harness Skills · object | null

Resposta

Resposta Bem-Sucedida

session

SessionRecord · object

obrigatório

Show child attributes

session_token

string | null

provider

enum<string> | null

Opções disponíveis:

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

Criar Sessão

Autorizações

Cabeçalhos

Corpo

Resposta