Skip to main content
POST
Python (SDK)

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.

Body

application/json
session_id
string
required
Required string length: 1 - 255
session_key
string | null
user_id
string
default:demo-user
session_kind
enum<string>
default:standard
Available options:
standard,
browser
ttl_seconds
integer
default:600
Required range: x >= 1
sandbox_features
enum<string>[]
Available options:
python,
git,
claude-code
runtime_profile
enum<string>
default:standard
Available options:
standard,
eval-python
memory_mounts
MemoryMount · object[]
queue_if_full
boolean
default:false
skip_llm_credential_exchange
boolean
default:false

Response

Successful Response

session
SessionRecord · object
required
session_token
string
required
provider
enum<string> | null
Available options:
in-memory,
runner-process,
runner-docker,
runner-firecracker