Skip to main content
GET
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.

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,
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
assignment_generation
integer
default:1
Required range: x >= 1
managed_services
ManagedServiceRecord · object[]
github_repository_manifest_version
integer | null
Required range: x >= 1
environment_id
integer | null
Required range: x >= 1
environment_setup_status
string | null
ttl_seconds
integer
default: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

Why a Coding Harness allocation entered stopped.

Recorded on the session row at the stop transition and cleared by resume, so a client that finds a stopped session can say whether the owner suspended it, the idle or absolute clock ran out, or the runner released it. Every value is resumable; termination is a different status.

Available options:
user_suspend,
idle_expired,
absolute_expired,
runner_drain,
runner_recovery
last_checkpoint_at
string<date-time> | null
last_checkpoint_generation
integer | null
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[]
api_key_id
string | null
permissions
string[]
sandbox_memory_mib
integer
default:256
created_at
string<date-time>
updated_at
string<date-time>