Cpu

Get Cpu Instance Types

get

Lists CPU-only instance types.

GET /v2/instance-types only returns instance types with a row in the auctions table, which CPU-only types deliberately don't have (adding one would make them spot-biddable). This is the discovery endpoint for the instance_type FID POST /v2/cpu/instances requires.

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful Response

application/json

fidstringRequiredExample: it_abc123456

namestringRequiredExample: h100.80gb.sxm

num_cpusintegerRequiredExample: 192

cpu_typestringRequiredExample: Intel

ram_gbintegerRequiredExample: 1800

num_gpusintegerRequiredExample: 8

gpu_typestringRequiredExample: H100

gpu_memory_gbintegerRequiredExample: 80

gpu_socketstringRequiredExample: SXM5

local_storage_gbintegerRequiredExample: 7800

network_typestring · nullableOptionalExample: InfiniBand

ib_countintegerRequiredExample: 8

bridge_countintegerRequiredExample: 4

hourly_pricenumberRequiredExample: 0.12

get/v2/cpu/instance-types

HTTPcURLJavaScriptPython

GET /v2/cpu/instance-types HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Successful Response

[
  {
    "fid": "it_abc123456",
    "name": "h100.80gb.sxm",
    "num_cpus": 192,
    "cpu_type": "Intel",
    "ram_gb": 1800,
    "num_gpus": 8,
    "gpu_type": "H100",
    "gpu_memory_gb": 80,
    "gpu_socket": "SXM5",
    "local_storage_gb": 7800,
    "network_type": "InfiniBand",
    "ib_count": 8,
    "bridge_count": 4,
    "hourly_price": 0.12
  }
]

Get Cpu Regions

get

Lists regions where CPU VMs are available (CPU_VMS_ENABLED on).

Discovery endpoint for the region POST /v2/cpu/instances requires - the console offers only these, so a user never picks a region the create would reject. Empty when no cluster is opted in.

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful Response

application/json

idstring · uuidRequired

namestringRequired

block_storage_enabledbooleanRequired

fileshare_storage_enabledbooleanRequired

k8s_enabledbooleanRequired

max_volume_size_tbintegerOptionalDefault: 32

max_volume_name_lengthintegerOptionalDefault: 64

get/v2/cpu/regions

HTTPcURLJavaScriptPython

GET /v2/cpu/regions HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Successful Response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "block_storage_enabled": true,
    "fileshare_storage_enabled": true,
    "k8s_enabled": true,
    "max_volume_size_tb": 32,
    "max_volume_name_length": 64
  }
]

Create Cpu Instance

post

Creates and instantly launches a self-serve CPU-only instance.

Unlike GPU reservations/spot bids, this is synchronous: the instance is launched in the same request, with no bid price and no auction involvement.

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringRequired

projectstringRequiredExample: proj_abc123456

instance_typestringRequiredExample: it_abc123456

regionstringRequiredExample: us-central1-a

volumesstring[]OptionalDefault: []

ssh_keysstring[] · nullableOptional

image_versionstring · nullableOptionalExample: imgver_abc123456

Responses

201

Successful Response

application/json

fidstringRequiredExample: inst_abc123456

namestringRequired

projectstringRequiredExample: proj_abc123456

created_atstring · datetimeRequiredExample: 2024-01-01T00:00:00Z

created_bystringRequiredExample: user_abc123456

instance_typestringRequiredExample: it_abc123456

regionstring · nullableOptionalExample: us-central1-a

bidstring · nullableOptionalExample: bid_abc123456

reservationstring · nullableOptionalExample: res_abc123456

ssh_destinationstring · nullableOptional

private_ipstring · nullableOptional

statusstring · enumRequiredExample: STATUS_NEWPossible values:

422

Validation Error

application/json

post/v2/cpu/instances

HTTPcURLJavaScriptPython

POST /v2/cpu/instances HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 193

{
  "name": "text",
  "project": "proj_abc123456",
  "instance_type": "it_abc123456",
  "region": "us-central1-a",
  "volumes": [
    "vol_abc123456"
  ],
  "ssh_keys": [
    "sshkey_abc123456"
  ],
  "image_version": "imgver_abc123456"
}

{
  "fid": "inst_abc123456",
  "name": "text",
  "project": "proj_abc123456",
  "created_at": "2024-01-01T00:00:00Z",
  "created_by": "user_abc123456",
  "instance_type": "it_abc123456",
  "region": "us-central1-a",
  "bid": "bid_abc123456",
  "reservation": "res_abc123456",
  "ssh_destination": "text",
  "private_ip": "text",
  "status": "STATUS_NEW"
}

Terminate Cpu Instance

delete

Terminates a CPU-only instance.

Stops the underlying VM, closes the backing order/allocation, and soft-deletes the managed customer cluster.

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

instance_fidstringRequiredExample: inst_abc123456

Responses

204

Successful Response

No content

422

Validation Error

application/json

delete/v2/cpu/instances/{instance_fid}

HTTPcURLJavaScriptPython

DELETE /v2/cpu/instances/{instance_fid} HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content