Clusters

List Kubernetes clusters

List all Kubernetes clusters

get/v0/clusters

Response

List of Kubernetes clusters

object'list' required

has_moreboolean required

Example response

{
  "object": "list",
  "data": [
    {
      "object": "kubernetes_cluster",
      "kubernetes_api_url": "https://cluster.example.com",
      "name": "richmond",
      "kubernetes_namespace": "sf-user123",
      "kubernetes_ca_cert": "-----BEGIN CERTIFICATE-----...",
      "contract": {
        "object": "contract",
        "id": "cont_k3R-nX9vLm7Qp2Yw5Jd8F",
        "created_at": "2025-07-11T20:41:37.423Z",
        "instance_type": "h100i",
        "shape": {
          "intervals": [
            "2025-07-11T20:41:37.423Z"
          ]
        },
        "colocate_with": [
          "cont_k3R-nX9vLm7Qp2Yw5Jd8F"
        ],
        "cluster_id": "clus_k3R-nX9vLm7Qp2Yw5Jd8F",
        "zone": "richmond",
        "is_node": true,
        "procurement_id": "proc_1234567890abcdef"
      }
    }
  ]
}

Changes

Changed in 4 of the 44 revisions of this API.109

May 15, 2026b819ba3108b393See the full diff
- ▲
  removed the required property details from the response with the 401 status
  response-required-property-removed
- ▲
  removed the required property details from the response with the 403 status
  response-required-property-removed
- ▲
  removed the required property details from the response with the 500 status
  response-required-property-removed
- ▲
  removed the required property message from the response with the 401 status
  response-required-property-removed
- ▲
  removed the required property message from the response with the 403 status
  response-required-property-removed
- ▲
  removed the required property message from the response with the 500 status
  response-required-property-removed
- ▲
  removed the required property type from the response with the 401 status
  response-required-property-removed
- ▲
  removed the required property type from the response with the 403 status
  response-required-property-removed
- ▲
  removed the required property type from the response with the 500 status
  response-required-property-removed
- ○
  added the required property error to the response with the 401 status
  response-required-property-added
- ○
  added the required property error to the response with the 403 status
  response-required-property-added
- ○
  added the required property error to the response with the 500 status
  response-required-property-added
This revision also has 20 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 11, 202673ad90aa5d193See the full diff
- ○
  the data/items/contract/oneOf[market-api_ContractResponse]/cluster_id/oneOf[market-api_ClusterId]/ response's property pattern was changed from "clus"_[0-9a-zA-Z]+ to clus_[0-9a-zA-Z_-]{1,21} for the status 200
  response-property-pattern-changed
- ○
  the data/items/contract/oneOf[market-api_ContractResponse]/colocate_with/items/ response's property pattern was changed from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21} for the status 200
  response-property-pattern-changed
- ○
  the data/items/contract/oneOf[market-api_ContractResponse]/id response's property pattern was changed from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21} for the status 200
  response-property-pattern-changed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Dec 9, 202500ce4132845e11See the full diff
- ▲
  added market-api_ZoneName to the data/items/contract/oneOf[market-api_ContractResponse]/zone response property oneOf list for the response status 200
  response-property-one-of-added
- ○
  removed market-api_ClusterName from the data/items/contract/oneOf[market-api_ContractResponse]/zone response property oneOf list for the response status 200
  response-property-one-of-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 7, 2025505757215a252See the full diff
- ○
  added the optional property data/items/contract/oneOf[market-api_ContractResponse]/procurement_id to the response with the 200 status
  response-optional-property-added
- ○
  added the required property data/items/contract/oneOf[market-api_ContractResponse]/is_node to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history