Listar Sessões

Typescript (SDK)

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

Typescript (SDK)

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": {}
    }
  ]
}

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.

Parâmetros de consulta

session_key

string | null

Only sessions created with this session_key. Apenas sessões criadas com esta session_key.

Resposta

Resposta Bem-Sucedida

session_id

string

obrigatório

user_id

string

obrigatório

session_key

string | null

org_id

string | null

team_id

string | null

network_policy

OutboundNetworkPolicy · object | null

Show child attributes

status

enum<string>

padrão:pending

Opções disponíveis:

queued,

pending,

provisioning,

running,

idle,

stopping,

stopped,

failed,

terminated

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

assignment_generation

integer

padrão:1

Intervalo obrigatório: x >= 1

managed_services

ManagedServiceRecord · object[]

Show child attributes

github_repository_manifest_version

integer | null

Intervalo obrigatório: x >= 1

environment_id

integer | null

Intervalo obrigatório: x >= 1

environment_setup_status

string | null

environment_network_access

enum<string> | null

Quanto da internet um convidado do Coding Harness alcança por meio do proxy.

Ordenado: cada nível inclui o anterior. O broker do modelo e a ferramenta de push/PR mka1-github alcançam o runner diretamente, e os repositórios do Ambiente são clonados no host antes da inicialização, então todos eles funcionam em todos os níveis, incluindo none.

Opções disponíveis:

none,

package_managers,

full

coding_harness_skills_digest

string | null

ttl_seconds

integer

padrão: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 que uma alocação de Coding Harness entrou em stopped.

Registrado na linha da sessão na transição de parada e limpo ao retomar, então um cliente que encontra uma sessão parada pode dizer se o proprietário a suspendeu, se o relógio de ociosidade ou o relógio absoluto se esgotou, ou se o executor a liberou. Todo valor pode ser retomado; encerramento é um status diferente.

Opções disponíveis:

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

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

api_key_id

string | null

permissions

string[]

memory_limit_mib

integer | null

sandbox_memory_mib

integer

padrão: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

Dataset generations

Organizations and access

Usage and budgets

Application utilities

Analytics

Legacy APIs

Additional APIs

Listar Sessões

Autorizações

Cabeçalhos

Parâmetros de consulta

Resposta