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.

Path Parameters

run_id
string
required

Response

The run, including its SSH details and endpoint once it is running.

created_at
string<date-time>
required
id
string
required
kind
enum<string>
required

What the run is for. A fine-tune ends on its own and its exit code is the outcome; a deployment serves traffic and runs until it is deleted. They are one resource because they are one pod, one provider and one script — the kind selects terminal semantics, not a different machine.

Available options:
finetune,
deployment
state
enum<string>
required
Available options:
requested,
provisioning,
running,
succeeded,
failed,
terminated
accelerator
string
deadline_at
string<date-time>
endpoint
string

Where the workload serves, once it is running. Only a deployment declares ports, so only a deployment reports an endpoint.

exit_code
integer

The workload's exit status. Provider status is not trusted for this: one provider reports the VM rather than the container.

gpu_count
integer
image
string
name
string
price_usd_hr
number
provider
string
reason
string

Why the run is in this state, e.g. ssh_setup_failed or budget_exhausted.

ssh
RunSSH · object

Connection details. The login user is provider dependent and is read from the provider, never assumed.

started_at
string<date-time>
terminal_at
string<date-time>