Kubernetes clusters

Get Kubernetes Clusters

get

Get all Kubernetes clusters for a project

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

projectstringRequired

Responses

200

Successful Response

application/json

fidstringRequired

projectstringRequired

namestringRequired

regionstringRequiredExample: us-central1-a

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

kube_hoststring · nullableOptional

ssh_keysstring[]Required

instancesstring[]Required

join_commandstring · nullableOptional

statusstring · enumRequiredPossible values:

deleted_atstring · datetime · nullableOptionalExample: 2024-01-01T00:00:00Z

k8s_versionstringRequired

user_fidstring · nullableOptional

422

Validation Error

application/json

get

/v2/kubernetes/clusters

HTTPcURLJavaScriptPython

GET /v2/kubernetes/clusters?project=text HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "fid": "text",
    "project": "text",
    "name": "text",
    "region": "us-central1-a",
    "created_at": "2024-01-01T00:00:00Z",
    "kube_host": "text",
    "ssh_keys": [
      "sshkey_abc123456"
    ],
    "instances": [
      "inst_abc123456"
    ],
    "join_command": "text",
    "status": "Pending",
    "deleted_at": "2024-01-01T00:00:00Z",
    "k8s_version": "text",
    "user_fid": "text"
  }
]

Create Kubernetes Cluster

post

Create a new Kubernetes cluster

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringRequired

projectstringRequiredExample: proj_abc123456

regionstringRequiredExample: us-central1-a

ssh_keysstring[] · min: 1Required

instance_typestringRequiredExample: it_abc123456

k8s_versionstring · enumOptionalDefault: 1.34Possible values:

image_versionstring · nullableOptionalExample: imgver_abc123456

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v2/kubernetes/clusters

HTTPcURLJavaScriptPython

POST /v2/kubernetes/clusters HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 186

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

{
  "fid": "text",
  "project": "text",
  "name": "text",
  "region": "us-central1-a",
  "created_at": "2024-01-01T00:00:00Z",
  "kube_host": "text",
  "ssh_keys": [
    "sshkey_abc123456"
  ],
  "instances": [
    "inst_abc123456"
  ],
  "join_command": "text",
  "status": "Pending",
  "deleted_at": "2024-01-01T00:00:00Z",
  "k8s_version": "text",
  "user_fid": "text"
}

Get Kubernetes Cluster

get

Get a specific Kubernetes cluster

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

cluster_fidstringRequired

Responses

200

Successful Response

application/json

fidstringRequired

projectstringRequired

namestringRequired

regionstringRequiredExample: us-central1-a

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

kube_hoststring · nullableOptional

ssh_keysstring[]Required

instancesstring[]Required

join_commandstring · nullableOptional

statusstring · enumRequiredPossible values:

deleted_atstring · datetime · nullableOptionalExample: 2024-01-01T00:00:00Z

k8s_versionstringRequired

user_fidstring · nullableOptional

422

Validation Error

application/json

get

/v2/kubernetes/clusters/{cluster_fid}

HTTPcURLJavaScriptPython

GET /v2/kubernetes/clusters/{cluster_fid} HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "fid": "text",
  "project": "text",
  "name": "text",
  "region": "us-central1-a",
  "created_at": "2024-01-01T00:00:00Z",
  "kube_host": "text",
  "ssh_keys": [
    "sshkey_abc123456"
  ],
  "instances": [
    "inst_abc123456"
  ],
  "join_command": "text",
  "status": "Pending",
  "deleted_at": "2024-01-01T00:00:00Z",
  "k8s_version": "text",
  "user_fid": "text"
}

Delete Kubernetes Cluster

delete

Delete a Kubernetes cluster

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

cluster_fidstringRequired

Responses

204

Successful Response

422

Validation Error

application/json

delete

/v2/kubernetes/clusters/{cluster_fid}

HTTPcURLJavaScriptPython

DELETE /v2/kubernetes/clusters/{cluster_fid} HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content