Lista de sesiones

Python (SDK)

from meetkai_mka1 import SDK


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

    res = sdk.sandbox.list()

    # Handle response
    print(res)

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

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

async function run() {
  const result = await sdk.sandbox.list({});

  console.log(result);
}

run();

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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 => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

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::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

[
  {
    "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_id": "demo-node-20260316",
    "user_id": "demo-user",
    "status": "running",
    "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:42:10Z"
  }
]

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

GET

api

sandbox

sessions

Python (SDK)

from meetkai_mka1 import SDK


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

    res = sdk.sandbox.list()

    # Handle response
    print(res)

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

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

async function run() {
  const result = await sdk.sandbox.list({});

  console.log(result);
}

run();

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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 => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

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::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

[
  {
    "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_id": "demo-node-20260316",
    "user_id": "demo-user",
    "status": "running",
    "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:42:10Z"
  }
]

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

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.

Respuesta

Respuesta Exitosa

session_id

string

requerido

user_id

string

requerido

session_key

string | null

org_id

string | null

team_id

string | null

status

enum<string>

predeterminado:pending

Opciones disponibles:

queued,

pending,

provisioning,

running,

idle,

stopping,

stopped,

failed,

terminated

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

assignment_generation

integer

predeterminado:1

Rango requerido: x >= 1

managed_services

ManagedServiceRecord · object[]

Show child attributes

github_repository_manifest_version

integer | null

Rango requerido: x >= 1

environment_id

integer | null

Rango requerido: x >= 1

environment_setup_status

string | null

ttl_seconds

integer

predeterminado:600

workspace_expires_at

string<date-time> | null

last_user_activity_at

string<date-time> | null

idle_expires_at

string<date-time> | null

absolute_expires_at

string<date-time> | null

stop_reason

enum<string> | null

¿Por qué una asignación de Coding Harness entró en stopped.

Registrado en la fila de la sesión en la transición de detención y borrado al reanudar, de modo que un cliente que encuentra una sesión detenida puede decir si el propietario la suspendió, si se agotó el reloj de inactividad o el reloj absoluto, o si el ejecutor la liberó. Cada valor puede reanudarse; la terminación es un estado diferente.

Opciones disponibles:

user_suspend,

idle_expired,

absolute_expired,

runner_drain,

runner_recovery

runner_cleanup_hold_reason

string | null

runner_cleanup_held_at

string<date-time> | null

last_checkpoint_at

string<date-time> | null

last_checkpoint_generation

integer | null

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

api_key_id

string | null

permissions

string[]

sandbox_memory_mib

integer

predeterminado:256

created_at

string<date-time>

updated_at

string<date-time>

⌘I

Responses and conversations

Models and routing

Images and audio

Files and retrieval

Agents

Tools and sandbox

Evals and feedback

Compute

Repositories and datasets

Organizations and access

Usage and budgets

Application utilities

Analytics

Legacy APIs

Additional APIs

Lista de sesiones

Autorizaciones

Encabezados

Respuesta