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,
coding_harness
resource_class
enum<string> | null

Server-owned workload sizing classes.

Resource classes are deliberately independent of the language/runtime profile. In particular, Coding Harness always uses the Medium class even when a caller sends a smaller or absent legacy memory_mib value.

Available options:
medium
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
environment_id
integer | null
Required range: x >= 1

Response

Successful Response

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