---
updatedAt: 2026-08-27T06:35:57.000Z
agentTools:
  projectIndex: https://docs.cast.ai/llms.txt
---

# /external-connections/v1beta/features

Lists all available features.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "servers": [
    {
      "url": "https://api.cast.ai/",
      "description": "US endpoint"
    },
    {
      "url": "https://api.eu.cast.ai/",
      "description": "EU endpoint"
    },
    {
      "url": "https://api.india.cast.ai/",
      "description": "India endpoint"
    }
  ],
  "info": {
    "title": "External Connections",
    "version": "0.0.1",
    "description": "ExternalConnectionsAPI manages external connections."
  },
  "security": [
    {
      "BearerAuth": []
    },
    {
      "ApiKeyAuth": []
    }
  ],
  "paths": {
    "/external-connections/v1beta/features": {
      "get": {
        "tags": [
          "ExternalConnectionsAPI"
        ],
        "description": "Lists all available features.",
        "operationId": "ExternalConnectionsAPI_ListFeatures",
        "parameters": [
          {
            "name": "page.limit",
            "in": "query",
            "description": "Defines the number of items that should be returned",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page.cursor",
            "in": "query",
            "description": "Cursor that defines token indicating where to start the next page.\n Empty value indicates to start from beginning of the dataset.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clouds",
            "in": "query",
            "description": "Optional cloud-provider filter. When non-empty, the response is filtered\n both at the feature and sub-feature level: sub-features that don't\n support any of the listed clouds are dropped, and a feature with no\n remaining sub-features is dropped entirely.",
            "schema": {
              "type": "array",
              "items": {
                "enum": [
                  "CLOUD_UNSPECIFIED",
                  "GCP",
                  "AWS",
                  "AZURE",
                  "ORACLE",
                  "NEBIUS"
                ],
                "type": "string",
                "format": "enum"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListFeaturesResponse"
                }
              }
            }
          },
          "default": {
            "description": "Default error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Status"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      },
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    },
    "schemas": {
      "BasePermissionCount": {
        "type": "object",
        "properties": {
          "cloud": {
            "type": "integer",
            "description": "Number of cloud IAM permission units in the base_permissions block only.",
            "format": "uint32"
          },
          "kubernetes": {
            "type": "integer",
            "description": "Number of Kubernetes RBAC permission units from the feature's base\n k8s_components only (no sub-feature components).",
            "format": "uint32"
          }
        },
        "description": "BasePermissionCount breaks down the base permission count by type.\n Only applies to features (not sub-features)."
      },
      "Feature": {
        "required": [
          "id",
          "name",
          "owner",
          "description",
          "subFeatures",
          "type",
          "category",
          "maxPermissionCount",
          "basePermissionCount"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable string identifier (e.g. \"cloud_connect\"). Kept for readability and\n future migration to opaque IDs."
          },
          "name": {
            "type": "string",
            "description": "Human-readable name of the feature."
          },
          "owner": {
            "type": "string",
            "description": "The team/owner responsible for the feature."
          },
          "description": {
            "type": "string",
            "description": "Description of what the feature does."
          },
          "subFeatures": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubFeature"
            },
            "description": "List of sub-features belonging to this feature."
          },
          "type": {
            "enum": [
              "TYPE_UNSPECIFIED",
              "CLOUD_CONNECT",
              "KIMCHI",
              "NODE_AUTOSCALING",
              "APA",
              "OMNI",
              "DBO",
              "STORAGE_AUTOSCALING",
              "WORKLOAD_AUTOSCALING",
              "COST_MONITORING",
              "POD_MUTATIONS",
              "KARPENTER_ENTERPRISE"
            ],
            "type": "string",
            "description": "Enum identifier mirroring `id`. Preferred field for clients that want to switch on feature identity.",
            "format": "enum"
          },
          "category": {
            "enum": [
              "CATEGORY_UNSPECIFIED",
              "CLUSTER",
              "ORGANIZATION"
            ],
            "type": "string",
            "description": "Category at which the feature applies (cluster vs organization).",
            "format": "enum"
          },
          "maxPermissionCount": {
            "type": "integer",
            "description": "Maximum number of distinct permission units this feature can require\n across all clouds, summed across all `grant_modes` alternatives.\n This is an upper bound — a single deployment will use fewer permissions\n because grant_modes are mutually exclusive. See the registry permissions.go\n file for exact counting semantics.\n Deprecated: use max_permission_details which breaks down by cloud vs kubernetes.",
            "format": "uint32"
          },
          "basePermissionCount": {
            "type": "integer",
            "description": "Number of permission units defined in the feature's base_permissions block.\n Base permissions mean the feature without any additional sub-features selected.\n Deprecated: use base_permission_details which breaks down by cloud vs kubernetes.",
            "format": "uint32"
          },
          "currentVersion": {
            "type": "string",
            "description": "Current registry version for this feature. Incremented whenever the\n effective permission set (base + all sub-features) changes."
          },
          "maxPermissionDetails": {
            "allOf": [
              {
                "$ref": "#/components/schemas/MaxPermissionCount"
              }
            ],
            "description": "Breakdown of the maximum permission count by cloud vs kubernetes."
          },
          "basePermissionDetails": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BasePermissionCount"
              }
            ],
            "description": "Breakdown of the base permission count by cloud vs kubernetes."
          }
        },
        "description": "Feature represents a top-level product capability."
      },
      "GoogleProtobufAny": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "description": "The type of the serialized message."
          }
        },
        "additionalProperties": true,
        "description": "Contains an arbitrary serialized message along with a @type that describes the type of the serialized message."
      },
      "ListFeaturesResponse": {
        "required": [
          "items"
        ],
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Feature"
            },
            "description": "The list of features."
          },
          "nextPageCursor": {
            "type": "string",
            "description": "The pagination cursor to retrieve the next page of features.\n Empty if this is the last page."
          }
        },
        "description": "Response message for listing features."
      },
      "MaxPermissionCount": {
        "type": "object",
        "properties": {
          "cloud": {
            "type": "integer",
            "description": "Maximum number of cloud IAM permission units across all clouds and\n grant_modes alternatives.",
            "format": "uint32"
          },
          "kubernetes": {
            "type": "integer",
            "description": "Maximum number of Kubernetes RBAC permission units (one per verb per\n resource per resource_name across all rules in all k8s components).",
            "format": "uint32"
          }
        },
        "description": "MaxPermissionCount breaks down the maximum permission count by type."
      },
      "Status": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].",
            "format": "int32"
          },
          "message": {
            "type": "string",
            "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client."
          },
          "details": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GoogleProtobufAny"
            },
            "description": "A list of messages that carry the error details.  There is a common set of message types for APIs to use."
          }
        },
        "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors)."
      },
      "SubFeature": {
        "required": [
          "id",
          "name",
          "description",
          "required",
          "supportedClouds",
          "type",
          "maxPermissionCount"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable string identifier."
          },
          "name": {
            "type": "string",
            "description": "Human-readable name of the sub-feature."
          },
          "description": {
            "type": "string",
            "description": "Description of what the sub-feature does."
          },
          "required": {
            "type": "boolean",
            "description": "Whether this sub-feature is required."
          },
          "supportedClouds": {
            "type": "array",
            "items": {
              "enum": [
                "CLOUD_UNSPECIFIED",
                "GCP",
                "AWS",
                "AZURE",
                "ORACLE",
                "NEBIUS"
              ],
              "type": "string",
              "format": "enum"
            },
            "description": "Supported cloud providers for this sub-feature."
          },
          "type": {
            "enum": [
              "TYPE_UNSPECIFIED",
              "CLOUD_CONNECT_FULL_ACCESS",
              "CLOUD_CONNECT_MINIMAL_PERMISSIONS",
              "CLOUD_CONNECT_COMMITMENTS",
              "CLOUD_CONNECT_AI_SERVICES",
              "CLOUD_CONNECT_CUR_BUCKET",
              "KIMCHI_MODEL_REGISTRIES",
              "KIMCHI_MODELS_CACHE",
              "KIMCHI_PROXY_STORAGE",
              "NODE_AUTOSCALING_IPV6",
              "NODE_AUTOSCALING_LOAD_BALANCERS_TARGET_BACKEND_POOLS",
              "NODE_AUTOSCALING_LOAD_BALANCERS_UNMANAGED_INSTANCE_GROUPS",
              "COST_MONITORING_STORAGE_METRICS",
              "COST_MONITORING_NETWORK_CONTEXT",
              "NODE_AUTOSCALING_SPOT_INTERRUPTION_HANDLING",
              "NODE_AUTOSCALING_POD_PINNING",
              "NODE_AUTOSCALING_CONTAINER_LIVE_MIGRATION",
              "POD_MUTATIONS_ENFORCEMENT",
              "WORKLOAD_AUTOSCALING_GPU_AWARE_SCALING",
              "WORKLOAD_AUTOSCALING_RESOURCE_QUOTA_AWARE_SCALING",
              "COST_MONITORING_NETWORK_MONITORING",
              "COST_MONITORING_GPU_MONITORING"
            ],
            "type": "string",
            "description": "Enum identifier mirroring `id`.",
            "format": "enum"
          },
          "maxPermissionCount": {
            "type": "integer",
            "description": "Maximum number of cloud IAM permission units this sub-feature can require\n across all clouds, summed across all grant_modes alternatives.\n Deprecated: use max_permission_details which breaks down by cloud vs kubernetes.",
            "format": "uint32"
          },
          "maxPermissionDetails": {
            "allOf": [
              {
                "$ref": "#/components/schemas/MaxPermissionCount"
              }
            ],
            "description": "Breakdown of the maximum permission count by cloud vs kubernetes."
          }
        },
        "description": "SubFeature is a grouping of permissions inside a feature."
      }
    }
  },
  "tags": [
    {
      "name": "ExternalConnectionsAPI"
    }
  ]
}
```