Skip to main content
GET
/
api
/
v1
/
sandbox
/
sessions
Python (SDK)
from mka1 import SDK


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

    res = sdk.sandbox.list()

    # Handle response
    print(res)
[
  {
    "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": [],
    "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"
  },
  {
    "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": [],
    "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:42:10Z"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.mka1.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Headers

​
X-On-Behalf-Of
string

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

Response

Successful Response

​
session_id
string
required
​
user_id
string
required
​
session_key
string | null
​
org_id
string | null
​
team_id
string | null
​
status
enum<string>
default:pending
Available options:
queued,
pending,
provisioning,
running,
idle,
stopped,
failed,
terminated
​
session_kind
enum<string>
default:standard
Available options:
standard,
browser
​
ttl_seconds
integer
default:600
​
workspace_expires_at
string<date-time> | null
​
sandbox_features
enum<string>[]
Available options:
python,
git,
claude-code
​
memory_mounts
MemoryMount · object[]
​
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>